Project: Fault Management and Maintenance (Doctor)

Doctor is fault management and maintenance project to develop and realize the consequent implementation for the OPNFV reference platform.

The goal of this project is to build fault management and maintenance framework for high availability of Network Services on top of virtualized infrastructure. The key feature is immediate notification of unavailability of virtualized resources from VIM, to process recovery of VNFs on them.
Requirement survey and development of missing feature in NFVI and VIM are in scope of this project to fulfill requirements for fault management and maintenance in NFV.

NOTE: Doctor project has an implementation of the requirements which we identified. Doctor project contributes all functional codes to upstream projects, such as OpenStack. Only testing tools and document can be found in OPNFV Doctor repository.

• Doctor project "Solution Brief"
• Deliverables/Documents:
  • Arno (EOL): Requirement (PDF)
  • Brahmaputra (EOL): Requirement (PDF), Platform overview (PDF), User guide (PDF), Config Guide (PDF), Manual for OpenStack Nova API (PDF)
  • Colorado: Scenario description, User guide, Release notes
  • Danube: Release notes, Config guide, User guide, Development guide(How to test, API), Requirement, Design 
  • Fraser:  Release notes, Config guide, User guide, Development guide(How to test, API), Testing
  • Latest build: Requirement
• Presentation Slides
  • Presentation & Demo at Prague Hackfest (Feb. 24, 2015)
  • Presentation at OpenStack Summit / OPNFV Hackfest (May 18, 2015)
  • Demo and Updates at Santa Clara Hackfest (July 30, 2015)
  • Controller, Presentation, Demo (video) at OPNFV Summit (Nov 9-12, 2015)
  • Maintenance API at Santa Clara Hackfest (March 15th, 2016)
  • Congress+Doctor, SFQM+Doctor at OpenStack Summit Austin (April 28, 2016)
  • PoC Demos (Handout, Congress, Vitrage-Recorded Demo), Inspector(Vitrage/Congress),  Doctor+SFQM, Deep Dive at OPNFV Summit 2016 (June 20-23, 2016)
  • Keynote demo, Inspectors, DPDK stats at OpenStack Summit Barcelona 2016 (Oct 25-28)
  • Updates, Doctor-QTIP: Faster, Higher, Stronger, Enabling Carrier-Grade Availability Within a Cloud Infrastructure, Maintenance PoC (recorded video) at OPNFV Summit Beijing 2017 (June 12-15, 2017)

  • Telco Scheduled Host Maintenance POC video (Oct 26, 2017), Telco Scheduled Host Maintenance POC ppt (Oct 10 2017)

  • Telco Scheduled Host Maintenance at OPNFV Plugfest Hillsboro (Dec 6 2017)

  • Infrastructure Maintenance & Upgrade: Zero VNF Downtime with OPNFV Doctor on OCP Hardware. OCP and ONS summit (March 2018) demo videoslides

  • How to gain VNF zero down-time during Infrastructure Maintenance and Upgrade OpenStack summit presentation (May 2018)

  • Rolling maintenance and upgrade in interaction with VNFM OpenStack summit forum (May 2018)
•  Current priority work: Rolling infrastructure maintenance and upgrade in interaction with application on top of it
  • Draft version of design quideline
  • Next steps:
    • Start to make implementation to OpenStack Fenix project
    • Complete test case in Doctor
    • Complete design document in Doctor
      
      
• Project Proposal (Presentation Slides, Old Version)
• Workspace
  • Planned Maintenance Design Guideline.pdfDoctor Dashboard https://etherpad.opnfv.org/p/doctor
  • Doctor Architecture
    • Figure sources: Opnfv_doctor_deliverable_v02.pptx
    • Discussion (Feb 6, 2015)
    • Proposed Implementation outside of Nova (Feb 10, 2015)
    • Relevance with ETSI NFV E2E Arch
    • SB API Discussion: 2015-04-14, 2016-02-23
  • Implementation Plan / Blueprints https://etherpad.opnfv.org/p/doctor_bps
    • Ceilometer: Rev.1, Rev.2, Rev.3, Rev.4
    • Nova: Original Plan (Mar 10, 2015), Updated Plan (Sep 1, 2015)
    • Nova Maintenance: May-10-2016, May-17-2016, June-21-2016
  • Release Planning
    • Brahmaputra Planning (EOL)
    • Colorado Planning (EOL)
    • Danube Planning (EOL)
    • Euphrates Planning (EOL)
    • Fraser Planning (current stable release, bug and security-supported)
    • Gambia Planning (under development)
• Doctor Graduation as mature project

• Meeting: Info & Logs, Note (Agenda), Join
• IRC: #opnfv-doctor @ Freenode (Web Chat)
• Mailing List: use opnfv-tech-discuss and tag your emails with [doctor] in the subject for easier filtering
• Review: https://gerrit.opnfv.org/gerrit/
• Repository: https://gerrit.opnfv.org/gerrit/
• Git Web: https://gerrit.opnfv.org/gerrit/gitweb?p=doctor.git;a=summary
• JIRA: https://jira.opnfv.org/browse/DOCTOR

Key Project Facts

Project: Fault Management project (doctor)
Project Creation Date: December 2, 2014
Project Category: Requirement
Lifecycle State: Mature
Primary Contact: Tomi Juvonen (tomi.juvonen@nokia.com)
Project Lead: Tomi Juvonen (tomi.juvonen@nokia.com)
Jira Project Name: Fault Management project
Jira Project Prefix: DOCTOR
Mailing list tag: [doctor]
IRC: Server:freenode.net Channel:#opnfv-doctor
Repository: doctor

Committers:
Ashiq Khan (NTT DOCOMO, khan@nttdocomo.com)
Bertrand Souville (NTT DOCOMO, souville@docomolab-euro.com)
Dong Wenjuan (ZTE, dong.wenjuan@zte.com.cn)
Gerald Kunzmann (NTT DOCOMO, kunzmann@docomolab-euro.com)
Ryota Mibu (NEC, r-mibu@cq.jp.nec.com)
Serge Manning (Sprint, Serge.Manning@sprint.com)
Tomi Juvonen (Nokia, tomi.juvonen@nokia.com)

Link to TSC approval of the project: http://meetbot.opnfv.org/meetings/opnfv-meeting/2014/opnfv-meeting.2014-12-02-14.58.html
Link(s) to approval of committer update:
http://lists.opnfv.org/pipermail/opnfv-tsc/2015-June/000905.html
http://lists.opnfv.org/pipermail/opnfv-tech-discuss/2015-June/003165.html
http://lists.opnfv.org/pipermail/opnfv-tech-discuss/2016-June/011245.html
http://lists.opnfv.org/pipermail/opnfv-tech-discuss/2016-July/011771.html

Contributors:

• Dirk Kutscher (NEC, Dirk.Kutscher@neclab.eu)
• Palani Chinnakannan (Cisco, pals@cisco.com)
• Petri Kemppainen (Nokia, petri.kemppainen@nokia.com)
• Tapio Tallgren (Nokia, tapio.tallgren@nokia.com)
• Zhangyu (Huawei, zhangyu11@huawei.com)
• Michael Godley (Intel, michael.godley@intel.com)
• Andreas Ripke (NEC, Andreas.Ripke@neclab.eu)
• Maryam Tahhan (Intel, maryam.tahhan@intel.com)
• Gurpreet Singh (Spirent, Gurpreet.Singh@spirent.com)
• Iben Rodriguez (iben.rodriguez@vmsec.com)
• Victor Laza (Cloudbase Solutions, vlaza@cloudbasesolutions.com)
• Alessandro Tosti (Telecom Italia, alessandro.tosti@telecomitalia.it)
• Dan Druta (AT&T, dd5826@att.com)
• Balázs Gibizer (Ericsson, balazs.gibizer@ericsson.com)
• Uli Kleber (Huawei, ulrich.kleber@huawei.com) 
• Yuanzhen Li (ZTE, li.yuanzhen@zte.com.cn)
• Masanori Miyazawa (KDDI, ma-miyazawa@kddilabs.jp)
• Tomonobu Niwa (KDDI, to-niwa@kddilabs.jp)
• Yujun Zhang (ZTE, zhang.yujunz@zte.com.cn)
• Woosung Jeon (KT DT, woosung.jeon@kt.com)
• Tarek EL-Basyouny (Deutsche Telekom)

If you would like to contribute to this project please add yourself to the contributors list and contact us. See also Developer Getting Started .