/
APPC VM/VNFC Level HealthCheck LCM API Enhancement

APPC VM/VNFC Level HealthCheck LCM API Enhancement

Mar 27, 2019

Abstract

APPC currently supports VNF level HealthCheck via the APPC LCM API.  Current functionality allows the client to request a VNF HealthCheck and APPC returns either a success or failure.  ONAP Control Loops require a more fine grained HealthCheck that provides a more robust feature set and a more fine grained response. 

Rationale

ONAP Control Loops require an APPC HealthCheck solution that provides a means of performing VNF and VM level checks.  Additionally, the HealthCheck response provided back to the APPC LCM API client needs to contain a payload with details on what and why the HealthCheck failed.  Currently, the APPC HealthCheck is only at the VNF Level and only returns a Success or Failure code.

One useful example of this enhanced functionality is the case where a VNF that contains for instance eight VMs.  The VNF level HealthCheck may find that seven out of the eight VMs are operating satisfactorily but one VM failed the HealthCheck.  The state along with the indication of which VM(s)/VNFC(s) failed and why the HealthCheck failed will be returned to the APPC LCM client.  The details returned for the failed VM(s)/VNFC(s) will allow the decision/policy manager to make a determination on whether or not to restart the one VM/VNFC or all VM(s)/VNFC(s) contained in the VNF.

Proposal

The solution will provide enhancements to the APPC HealthCheck functionality wherein APPC will allow for both a VNF level HealthCheck as well as a VM/VNFC level HealthCheck. Additionally, the response will return more fine grained details on the HealthCheck results.

VNF Level HealthCheck

  • Request:

    • Will conform to the APPC LCM VNF Level Request format per the APPC LCM API Guide.

    • The HealthCheck API will perform LCM request validations.

  • Response:

    • VNF level HealthCheck response will:

VM Level HealthCheck

  • Request:

Backward Compatibility

  • The current proposal is to develop a new API and persist the existing HealthCheck API in order to support the integrity of the current HealthCheck.

References