Work in progress

Goal

• Migrate PNF PNP workflow to Building Blocks (BBs/GR_API).
• Include newly created BBs in Service-Macro-Create flow.
• Leave legacy implementation using VNF_API intact.

By PNF PNP workflow we understand 2 BPMNs:

...

Both included in CreateVcpeResCustService_simplified BPMN

...

JIRA

...

...

AssignPnfBB

• Responsibility:
  • Creates PNF entry in AAI
  • Makes a link in AAI between Service entry and PNF entry
• Currently implemented in CreateAndActivatePnfResource.bpmn
• Things to consider:
  • In current implementation connecting PNF entry in AAI with service entry is done at the end of CreateAndActivatePnfResource (after the "PNF ready" event is received)

WaitForPnfReadyBB

• Responsibility:
  
  • Waits for "PNF ready" event sent from PRH to DMaaP
• Currently implemented in CreateAndActivatePnfResource.bpmn
• Things to consider:
  • BBS-related parameters stored in AAI?
  • Make new BBs generic enough (i.e. wait for an event sent to DMaaP) that they could be reused in other flows (request from Seshu)

ConfigAssignPnfBB

• Responsibility:
  
  • Runs config assign via CDS
• Currently implemented in ConfigurePnfResource.bpmn
• Things to consider:
  • New approach to calling CDS/controllers - ControllerExecutionBB/actor in SDC model (Henry Xie, see https://wiki.onap.org/display/DW/SO+Weekly+Meeting+2019-12-4)
  • Service decompositioon should handle SkipPostInstantiationConfiguration

ConfigDeployPnfBB

• Responsibility:
  
  • Runs config deploy via CDS
• Currently implemented in ConfigurePnfResource.bpmn
• Things to consider:
  
  • New approach to calling CDS/controllers - ControllerExecutionBB/actor in SDC model (Henry Xie, see https://wiki.onap.org/display/DW/SO+Weekly+Meeting+2019-12-4)
  • Service decompositioon should handle SkipPostInstantiationConfiguration
    

ActivatePnfBB

• Responsibility:
  • Sets PNF orchestration status in AAI as Active

Proposed sequence in Service-Macro-Create flow

1. AssignServiceInstanceBB
2. CreateNetworkCollectionBB
3. AssignNetworkBB
4. AssignVnfBB
5. AssignVolumeGroupBB
6. AssignVfModuleBB
7. ConfigAssignVnfBB
8. AssignPnfBB
9. WaitForPnfReadyBB
10. ActivatePnfBB
11. CreateNetworkBB
12. ActivateNetworkBB
13. CreateVolumeGroupBB
14. ActivateVolumeGroupBB
15. CreateVfModuleBB
16. ActivateVfModuleBB
17. ConfigDeployVnfBB
18. ActivateVnfBB
19. ActivateNetworkCollectionBB
20. ActivateServiceInstanceBB

What about config assign and config deploy?

SO framework - required changes

API handler

GR API

SO API currently doesn't allow to send PNF information in user data section. 

Here's the proposed request which includes PNFs:

...

Involved parties

• Lukasz Grech, Damian Nowak - PNF PNP workflow migration to BBs
• Oskar Malm - ConfigurePnfResource.bpmn (previous, non-BB implementation)
• Henry Xie - SO-CDS integration, new API for calling CDS from SO
• Yuriy Malakov - CDS, SO-CDS integration
• Rahul Tyagi - PNF SW upgrade, SO-CDS integration

Proposed building blocks

AssignPnfBB

• Responsibility:
  • Creates PNF entry in AAI (with PNF name chosen by user)
  • Additionally stores PNF model-related parameters in AAI (

    Jira Legacy
    server System Jira columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 4733707d-2057-3a0f-ae5e-4fd8aff50176 key SO-2640

    ):
    • model-customization-id
    • model-invariant-id
    • model-version-id
  • Makes a link in AAI between Service entry and PNF entry
  • Sets PNF orchestration status in AAI to Assigned
• Currently implemented in CreateAndActivatePnfResource.bpmn

WaitForPnfReadyBB

• Responsibility:
  
  • Waits for "PNF ready" event sent from PRH to DMaaP
    • pnfCorrelationId from the event must match PNF instance name provided by the user during service instantiation
  • Sets PNF orchestration status in AAI to:
    • Register - when starting to wait for PNF ready event
    • Registered - when PNF ready event is successfully received
• Currently implemented in CreateAndActivatePnfResource.bpmn

Support for config assign (ControllerExecutionBB, action: configAssign)

• Responsibility:
  
  • Runs config assign via CDS
• Currently implemented in ConfigurePnfResource.bpmn
• We will reuse generic BPMN for calling CDS (ControllerExecutionBB)
• Things to consider:
  • SkipPostInstantiationConfiguration should be taken into account

Support for config deploy (ControllerExecutionBB, action: configDeploy)

• Responsibility:
  
  • Runs config deploy via CDS
• Currently implemented in ConfigurePnfResource.bpmn
• We will reuse generic BPMN for calling CDS (ControllerExecutionBB)
• Things to consider:
  
  • SkipPostInstantiationConfiguration should be taken into account

ActivatePnfBB

• Responsibility:
  • Sets PNF orchestration status in AAI as Active

Sequence in Service-Macro-Create flow

1. AssignServiceInstanceBB
2. CreateNetworkCollectionBB
3. AssignNetworkBB
4. AssignVnfBB
5. AssignVolumeGroupBB
6. AssignVfModuleBB
7. AssignPnfBB
8. WaitForPnfReadyBB
9. ControllerExecutionBB (action: configAssign, scope: pnf)
10. ControllerExecutionBB (action: configDeploy, scope: pnf)
11. ActivatePnfBB
12. ConfigAssignVnfBB
13. CreateNetworkBB
14. ActivateNetworkBB
15. CreateVolumeGroupBB
16. ActivateVolumeGroupBB
17. CreateVfModuleBB
18. ActivateVfModuleBB
19. ConfigDeployVnfBB
20. ActivateVnfBB
21. ActivateNetworkCollectionBB
22. ActivateServiceInstanceBB

SO - required changes

API handler

GR API

SO API currently doesn't allow to send PNF information in user data section. 

Here's the proposed request which includes PNFs:

{
    "requestDetails":{
           "instanceNamemodelInfo":service_instance_name,{
            "productFamilyId":"ff9262e1-5e31-48dc-aa71-e3f0a7ba1b8c"modelInvariantId":service_model_invariant_uuid,
            "sourcemodelVersionId":"VID"service_model_uuid,
            "suppressRollbackmodelName": Falseservice_model_name,
            "requestorIdmodelType":"demoservice",
        },    "modelVersion":"1.0"
    "requestParameters":{    },
        "subscriptionServiceTypeowningEntity":"vFW",{
            "aLaCarteowningEntityId": False"3fa3e96c-dd51-4c77-818d-f130b613f1f8",
            "userParamsowningEntityName":["OE-Demonstration"
        },
        "subscriberInfo":{
            "globalSubscriberId":"Demonstration"
       "service":{ },
        "requestInfo":{
              "modelInfoinstanceName":{service_instance_name,
               "productFamilyId":"ff9262e1-5e31-48dc-aa71-e3f0a7ba1b8c",
            "modelVersionIdsource":service_model_uuid"VID",
            "suppressRollback": False,
              "modelNamerequestorId":service_model_name,"demo"
        },
        "requestParameters":{
            "modelTypesubscriptionServiceType":"servicevFW",
            "aLaCarte": False,
          },  "userParams":[
                {
     "instanceName":service_instance_name,               "service":{
         "instanceParams":[],                         "resources"modelInfo":{
                            "pnfsmodelVersionId":[service_model_uuid,
                            "modelName":service_model_name,
   {                         "modelType":"service"
           "modelInfo":{                },
                        "modelCustomizationNameinstanceName":nfservice_resourceinstance_name,
                           "instanceParams":[],
            "modelCustomizationId":nf_resource_uuid,            "resources":{
                            "modelInvariantIdpnfs":nf_model_invariant_uuid,[
                                {
          "modelVersionId":nf_model_uuid,                          "modelInfo":{
              "modelName"                          "modelCustomizationName":nf_modelresource_name,
                                        "modelTypemodelCustomizationId":"pnf"nf_resource_uuid,
                                        "modelVersionmodelInvariantId":"1.0"nf_model_invariant_uuid,
                                    },    "modelVersionId":nf_model_uuid,
                                        "platformmodelName":{nf_model_name,
                                        "platformNamemodelType":"Platform-Demonstrationpnf",
                                    },    "modelVersion":"1.0"
                                "lineOfBusiness":{    },
                                    "lineOfBusinessNameplatform":"LOB-Demonstration"{
                                        },"platformName":"Platform-Demonstration"
                                    "productFamilyId":"ff9262e1-5e31-48dc-aa71-e3f0a7ba1b8c"},
                                    "instanceParamslineOfBusiness":[],
  {
                                 "instanceName":nf_instance_name       "lineOfBusinessName":"LOB-Demonstration"
                         }           },
                 ]                   "productFamilyId":"ff9262e1-5e31-48dc-aa71-e3f0a7ba1b8c",
     }                     }          "instanceParams":[],
      },                 {             "instanceName":nf_instance_name
       "Homing_Solution":"none"                         }
                            ]
                        }
                }
}

Building Block framework

Service decomposition (Retrieve BB Execution List)

• PNFs should recognized in service model and proper BBs should be assigned for execution.

GeneralBuildingBlock initialization (BB Input Setup)

• PNF resources should be properly initialized in GeneralBuildingBlock->ServiceInstance

...

    }
                },
                {
                    "Homing_Solution":"none"
                }
            ]
        }
    }
}

Building Block framework

Service decomposition (Retrieve BB Execution List)

• PNFs should be recognized in service model and proper BBs should be assigned for execution.

GeneralBuildingBlock initialization (BB Input Setup)

• PNF resources should be properly initialized in GeneralBuildingBlock→ServiceInstance

Generic controller BB working with PNFs

• Update will be needed for BBInputSetup and WorkflowAction to support BBs which do not contain PNF in its name. Similarly as it was done for VNFs:
  • https://gerrit.onap.org/r/c/so/+/106108
  • https://gerrit.onap.org/r/c/so/+/106637 

PNF PNP workflow integration with CDS

VID - required changes

Updates for service macro instantiation:

...

• Are all required PNF parameters included in GeneralBuildingBlock->ServiceInstance→Pnf? 
  • Currently those are:
    • pnf-id
    • pnf-name
    • role
    • orchestration-status
    • cloud-region
  • Currently AAI schema (aai_schema_v19.xsd) for PNF contains: 
    • Fields: pnf-name, pnf-name2, selflink, pnf-name2-source, pnf-id, equip-type, equip-vendor, equip-model, management-option, orchestration-status, ipaddress-v4-oam, sw-version, in-maint, frame-id, serial-number, ipaddress-v4-loopback-0, ipaddress-v6-loopback-0, ipaddress-v4-aim, ipaddress-v6-aim, ipaddress-v6-oam, inv-status, resource-version, prov-status, nf-role, admin-status, operational-status, model-customization-id, model-invariant-id, model-version-id (from SO cataloge), pnf-ipv4-address, pnf-ipv6-address
    • Sub-structures: software-versions, relationship-list, p-interfaces, lag-interfaces, vrfs
  •  BBInputSetup implementation does not mention PNF at all - is it even initialized in GeneralBuildingBlock?
  • PNF ip is resolved by CDS by PNF ID (it should be in AAI) - it's populated by PRH
• How to include new BBs in Service-Macro-Create flow?Where to put new BBs in the flow sequence?
  
  • Service decomposition in WorkflowActionBB may not unserstand PNFs (Retrieve BB Execution List)
  • Service decompositioon decomposition should handle SkipPostInstantiationConfiguration
• PNF orchestration status changes in AAI - which states should be assigned in which steps of the workflowShould we have ActivatePnfBB? 
• PNF SW upgrade (Oskar Malm)
  • PNF should be active - PNP is finished
  • new Upgrade flow will be created (BBs vs traditional considered)
• 5G NRM Configuration - plan for new BB which invokes configuration via CDS of NRM resource(?) (Yaoguang Wang, see https://wikilf-onap.onapatlassian.orgnet/wiki/display/DW/SO+Weekly+Meeting+2019-12-4)
• Make new BBs generic enough that they could be reused in other flows (request from Seshu)
• Service-Macro-Delete
  • Should we delete PNF resource from AAI on service deletion?
    
    • We plan to leave it. What orchestration status should it get? Inactive?