Support ETSI NFV-SOL based error-handling

ETSI specifications within the NFV Architecture Framework [1] describe the main aspects of NFV development and usage based on of the industry needs, feedback from SDN/NFV vendors and telecom operators. These specifications include the REST API and data model architecture which is used by NFV users and developers in related products.

Problem description

In the current Tacker implementation based on ETSI NFV-SOL, Tacker executes its own error-handling operation which reacts to errors the VNFM encounters.

However, those operations are not aligned with the current ETSI NFV data-model. As a result, there might be lack of compatibility with 3rd party VNFs [4], as they are developed according to ETSI NFV specifications. Support of key ETSI NFV specifications will significantly reduce efforts for Tacker integration into Telecom production networks and also will simplify further development and support of future standards.

Proposed change

Introduces a new interface to VNFM for reverting VNF lifecycle management operations for VNF instances. The operation provided through this interface is:

  • Rollback

1) Flow of Rollback of LCM resource

Precondition: The operation state should be set in “FAILED_TEMP” state. Moreover, ongoing lifecycle management operation should be either VNF instantiation or Scaling-out.

The procedure consists of the following steps as illustrated in each sections.

1-1) Sending of Notification

  • VNFM holds the Callback URL sent by consumer via “Subscription API” in advance.

  • Depending on the progress status of the lifecycle management operations, send API notification (Notify) to notify the status change and update the internal operation_status.

  • The node that received the notification returns 204 NO CONTENT indicating success and grasps the sequence status of VNFM.

The states that VNFM notifies with VNF Rollback are as follows:



Postcondition: When the rollback operation is completed successfully, the operation state will be changed in “ROLLEDBACK” state.

1-2) Rollback LCM operation

When a Rollback request is received, VNFM operates to stop the lifecycle operation normally while it is terminated. When the rollback operation is executed during VNF instantiation, VNFM removes all VMs and resources.

When the rollback operation is executed for Scale-out, VNFM deletes all VMs and resources specified in the middle of Scale-out operation.

User needs to separately implement Rollback sub-operation by VNF Configuration. In case of Scale-out, VNFM starts VNF Configuration for rollbacking. Instantiation does not launch VNF Configutration.

Postcondition: When Rollback is successfully completed, the instantiation state has transited to NOT_INSTANTIATED state only for “Instantiate VNF”.



Data model impact


REST API impact

The following RESTful API will be added. This RESTful API will be based on ETSI NFV SOL002 and SOL003 [3].

  • Name: Rollback VNF oepration
    Description: Request to rollback VNF lifecycle operations
    Method type: POST
    URL for the resource: /vnflcm/v1/vnf_lcm_op_occs/{vnfLcmOpOccId}/rollback
    Request: Resource URI variables for this resource




    Identifier of the related VNF lifecycle management operation occurrence.


    Data type


    Response Codes




    Success 202
    Error 404 409

    The request has been accepted for processing, but processing has not been completed.

Security impact


Notifications impact


Other end user impact

Add new OSC commands in python-tackerclient to invoke rollback operation of VNF instances API.

Performance Impact


Other deployer impact

The previously created VNFs will not be allowed to be managed using the newly introduced APIs.

Developer impact




Primary assignee:

Keiko Kuriu <>

Work Items

  • Add new REST API endpoints to Tacker-server for LCM notifications interface of VNF instances.

  • Make changes in python-tackerclient to add new OSC commands for calling rollback operation of VNF instances RESTful APIs.

  • Add features which Tacker consumes Rest API for Notifications

  • Add new unit and functional tests.

  • Change API Tacker documentation.


To execute rollback operations, consumer should invoke subscription operaiton [5] in advance in order to get “vnfLcmOpOccId” related to the target LCM operation.


Unit and functional test cases will be added for VNF lifecycle management of VNF instances.

Documentation Impact

Complete user guide will be added to explain how to invoke VNF lifecycle management of VNF instances with examples.