Table of Contents

BUSINESS DRIVERS

This section describes Business Drivers for this Use Case.

Executive Summary - PNF software updates are routine for network upgrades to support new features, improve efficiency or increase capacity on the field, and to eliminate bugs. This use case positions ONAP as a vantage point in orchestrating and managing PNF software upgrades inline with the business and service objectives.   

Business Impact - Deployment and orchestration of new network services over both VNFs and PNFs in a model and software driven way simplifies the network management. As 5G networks will host a large number of PNFs from multiple vendors, streamlining service upgrades that involve PNF software changes through ONAP will reduce the OPEX substantially.  

Business Markets - Carriers both in the mobile and fixed-line space host PNFs at the edge of the network. New 5G deployments as well as legacy 4G systems in the mobile carrier space should be considered as target markets. 

Funding/Financial Impacts - Orchestrating PNF software updates via an ONAP deployment will enable better service planning, faster introduction of new network services over field-deployed PNFs, and reduce the operational costs.

Organization Mgmt, Sales Strategies - Harmonizing PNF and VNF software management in a model and workflow driven manner is essential in 5G systems where PNFs will continue to exist in large numbers and they are expected to have more frequent software upgrades (as they will have more capabilities that can be controlled or upgraded via software). Thus ONAP can be the "go-to" solution if this harmonization can be done successfully.

Current Status of PNF Software Upgrade

PNF in place software upgrade is supported in Casablanca and updated in Dublin

More details, 5G - PNF Software Update & 5G - PNF SW Upgrade (Casablanca carry-over items)

PNF Software Upgrade Scenarios

There are 4 scenarios are proposed:

  1. Using direct Netconf/Yang interface with PNF
  2. Enable service level LCM operations
  3. Using Ansible protocol with EM
  4. Using Netconf/Yang interface with EM

Common Tasks for all scenarios

SO workflow Example to upgrade one PNF instance

SO activities operations:

LCM evolution with API Decision Tree

Development Status

Impacts Summary

PROJECTPTLUser Story / EpicRequirement
A&AI


AAF

APPC


CLAMP

CC-SDK Epic #1: PNF Software Upgrade
  1. Support LCM API / self service API for downloadNESw and activateNESw actions
  2. Provide CDS blueprint for downloadNESw and activateNESw (Test only)
DCAE

DMaaP

External API

MODELING

Multi-VIM /

Cloud



OOF

POLICY



PORTAL

SDN-CEpic #1: PNF Software Upgrade
  1. Support LCM API for downloadNESw and activateNESw actions
  2. Provide ansible playbooks for downloadNESw and activateNESw (Test only)
SDCEpic #1: PNF Software Upgrade
  1. support generic workflow design
  2. CBA association enhancement to support PNF upgrade. Impacts on PNFD AID model
  3. CBA association enhancement to support VNF upgrade. Impacts on VNFD AID model
SOEpic #1: PNF Software Upgrade
  1. Support generic PNF CM workflow, including SO building block shall be extended to support PNF LCM actions
  2. SO API extension: PNF software upgrade with target software version
  3. SO BB for downloadNESw, activateNESw, preCheck, postCheck
  4. API (LCM or CDS SS) selection within the same BB
VIDEpic #1: PNF Software Upgrade
  1. trigger PNF Sw upgrade workflow, providing corresponding parameter values
VNFRQTSEpic #1: PNF Software Upgradeupdate the PNF/VNF upgrade requirements 
VNF-SDK

CDSEpic #1: PNF Software Upgrade
  1. Provide CDS blueprint for downloadNESw and activateNESw
  2. API (LCM or CDS SS) selection within the same BB
IntegrationBrian Freeman

List of PTLs: Approved Projects

Requirements Tickets

Scenario 1 Using direct Netconf/Yang interface with PNF

Scenario 2 Enable service level LCM operations

Scenario 3 Using Ansible protocol

Scenario 4 Netconf/Yang interface with EM

Test Status

1There should be a test case for each item in the sequence diagram

NOT YET TESTED

2create additional requirements as needed for each discreet step

COMPLETE

3Test cases should cover entire Use Case

PARTIALLY COMPLETE

Test Cases should include enough detail for testing team to implement the test

 FAILED

Scenario 1: PNF Software Upgrade Using direct NETCONF/YANG interface with PNF Test Cases 

Test Case IdTest CaseTest TypeStatus
TEST-CASE-1Test Check in SDNC certificates to connect node are properly installed Integration(robot)COMPLETE
TEST-CASE-2Test Blue print archive is properly uploaded to blueprint-processorIntegration(robot)COMPLETE
TEST-CASE-3Test resource package and service is successfully distributed from SDC to SOIntegration(robot)

COMPLETE

TEST-CASE-4Test all the pnf workflows are successfully fetched from SOIntegration(robot)COMPLETE
TEST-CASE-5Test Service instantiation is triggered from VID to SO and status is COMPLETED for preparation(Download) workflowIntegration(robot)COMPLETE
TEST-CASE-6Verify on PNF-simulator that there is pnf_sw_version-2.0.0 entry added into the list and its status is DOWNLOAD-COMPLETEDIntegration(robot)COMPLETE
TEST-CASE-7Test Service instantiation is triggered from VID to SO and status is COMPLETED for software upgrade workflowIntegration(robot)COMPLETE
TEST-CASE-8Verify on PNF-simulator that there is pnf_sw_version-3.0.0 entry added into the list and its status is ACTIVATION-COMPLETEDIntegration(robot)COMPLETE
TEST-CASE-9Verify on AAI-Simulator that for pnf PNFDemo sw-version is pnf_sw_version-3.0.0.Integration(robot)COMPLETE


Test Cases Details:

All the test cases for Scenario 1 are robot tests that can be ran automatically from the same steps which will be shown below.

Testing Steps


#

Step

Expected Result

1

In the Integration csit repo, run plans/usecases/pnf-sw-upgrade robot tests

Pnf-sw-upgrade robot tests running

2

Wait for the tests to finish

Tests finished without timeout

3

Check the test reports

All test cases run successfully


Status (Pass/Fail)

ONAP Jira Ticket:

·         https://jira.onap.org/browse/INT-1308

ONAP PNF SW Upgrade Daily CSIT Tests:

·        https://logs.onap.org/production/vex-yul-ecomp-jenkins-1/usecases-master-verify-csit-pnf-sw-upgrade/17/log.html.gz

Testing Lab

CSIT PNF SW Upgrade https://jenkins.onap.org/job/usecases-master-verify-csit-pnf-sw-upgrade/


Test Case ID

Test Case Name

Description

Release

TEST-CASE-1

Test Check in SDNC certificates to connect node are properly installed

This test will check whether the keystore is setup and certificates installed for SDNC and ODL once SDNC is installed

Frankfurt

TEST-CASE-2

Test Blueprint archive is properly uploaded to blueprint-processor

Test Blueprint archive is properly uploaded to blueprint-processor

Frankfurt

TEST-CASE-3

Test resource package and service is successfully distributed from SDC to SO

Test resource package and service is successfully distributed from SDC to SO

Frankfurt

TEST-CASE-4

Test all the PNF workflows are successfully fetched from SO

Test all the PNF workflows are successfully fetched from SO

Frankfurt

TEST-CASE-5

Test Service instantiation is triggered from VID to SO and status is COMPLETED for preparation (Download) workflow

Test Service instantiation is triggered from VID to SO and status is COMPLETED for preparation (Download) workflow

Frankfurt

TEST-CASE-6

Verify on PNF-simulator that there is pnf_sw_version-2.0.0 entry added into the list and its status is DOWNLOAD-COMPLETED

Verify on PNF-simulator that there is pnf_sw_version-2.0.0 entry added into the list and its status is DOWNLOAD-COMPLETED

Frankfurt

TEST-CASE-7

Test Service instantiation is triggered from VID to SO and status is COMPLETED for software upgrade workflow

Test Service instantiation is triggered from VID to SO and status is COMPLETED for software upgrade workflow

Frankfurt

TEST-CASE-8

Verify on PNF-simulator that there is pnf_sw_version-3.0.0 entry added into the list and its status is ACTIVATION-COMPLETED

Verify on PNF-simulator that there is pnf_sw_version-3.0.0 entry added into the list and its status is ACTIVATION-COMPLETED

Frankfurt

TEST-CASE-9

Verify on AAI-Simulator that for pnf PNFDDemo sw-version is pnf_sw_version-3.0.0

Verify on AAI-Simulator that for pnf PNFDDemo sw-version is pnf_sw_version-3.0.0

Frankfurt

Scenario 2: PNF Software Information On boarding Test Cases

Test Case IdTest CaseTest TypeStatus

TEST-CASE-1

Test Onboarding of PNF Package with non-mano Software Information in SDC Sanity-API testSanity

Local SDC deployment: COMPLETE

SDC Daily API Sanity: COMPLETE

TEST-CASE-2Test Onboarding of PNF Package with non-mano Software Information in SDC GUIManualLocal SDC deployment: COMPLETE
TEST-CASE-3Test Onboarding of PNF Package with non-mano Software Information in SDC Sanity-UI testSanity

Local SDC deployment: COMPLETE

SDC Daily UI Sanity: COMPLETE 

Test Types:

Test Cases Details

Test Case ID

TEST-CASE-1

Test Case NameTest Onboarding of PNF Package with non-mano Software Information in SDC Sanity-API test
DescriptionThe test will onboard PNF Packages with non-mano Software Information in the SDC Sanity API test flow
ReleaseFrankfurt
Preconditions

Local SDC or ONAP deployment available and running

Testing Steps


#StepExpected Result
1

Run SDC sdc-api-tests

sdc-api-tests running
2

Wait for the tests to finish

Tests finished without timeout
3Check the test reportsAll test cases run successfully


Status (Pass/Fail)

Local SDC deployment: COMPLETE

SDC Daily API Sanity: COMPLETE

Testing LabLocal SDC deployment, SDC Daily API Sanity run https://jenkins.onap.org/view/sdc/job/sdc-master-verify-csit-sanity-testng/


Test Case ID

TEST-CASE-2

Test Case NameTest Onboarding of PNF Package with non-mano Software Information in SDC GUI
DescriptionManually onboard the PNF Package with non-mano Software Information in the SDC GUI, creating a VSP and importing as a ONAP PNF Resource.
ReleaseFrankfurt
Preconditions
  • Local SDC or ONAP deployment available and running;
  • A SDC Vendor License Model already created;
  • A valid PNF Package with non-mano Software Information.
Testing Steps


#StepExpected Result
1

Access SDC GUI as a Designer.

SDC Home screen is shown.

2

Go to the Onboard Workspace .

Onboard workspace is shown.
3Click on "CREATE NEW VSP"."New Software Product" popup is shown.
4Fill in the "New Software Product" required information, selecting "Network Package" as the Onboarding Procedure and click on create.The VSP Overview page is shown.
5In the VSP Overview screen, Software Product Attachments, click on select file and provide the PNF Package with non-mano Software Information.The VSP attachment validation screen is shown.
6In the VSP attachment validation, click on the Submit button.A "Commit & Submit" popup is shown.
7Fill the "Commit & Submit" popup with any comment and click in the "Commit & Submit" button.A "Submit Succeeded" information is shown.
8Close the "Submit Succeeded" popup and go to the Home workspace.SDC Home screen is shown.
9Hover your mouse to the IMPORT square and click in "Import VSP".A "Import VSP" modal is shown with the SDC VSP list.
10Search for the created VSP.The created VSP is shown in the VSP list.
11Click on the VSP and then in the Download VSP link.The VSP CSAR package is downloaded.
12Open the CSAR package and check that the software information artifact is present in the folder Artifacts/Informational/PNF_SW_INFORMATION.The onboarded artifact is present on the folder.
13Go back to the "Import VSP" modal and click on the "Import VSP" link.The Resource Design General page is open with the PNF package information.
14Click on the "Create" button to create the resource.A creation confirmation message is shown.
15On the left panel, click on the "Properties Assignment".The "Properties Assignment" page is shown.
16Verify that the "software_versions" property is present and filled with the versions provided in the software information artifact.The "software_versions" property is present with the expected content.


Status (Pass/Fail)

Local SDC deployment: COMPLETE

Used package: onboarding-package.csar

Test case recording: Onboard_PNF_Software_Version.mkv

Testing LabLocal SDC deployment


Test Case ID

TEST-CASE-3

Test Case NameTest Onboarding of PNF Package with non-mano Software Information in SDC Sanity-UI test
DescriptionThe test will onboard the PNF Package with non-mano Software Information in the UI SDC Sanity test flow
ReleaseFrankfurt
Preconditions

Local SDC or ONAP deployment available and running

Testing Steps


#StepExpected Result
1

Run SDC sdc-ui-tests

sdc-ui-tests running
2

Wait for the tests to finish

Tests finished without timeout
3Check the test reportsAll test cases run successfully


Status (Pass/Fail)
Testing LabLocal SDC deployment, SDC Daily UI Sanity run https://jenkins.onap.org/view/sdc/job/sdc-master-csit-uiSanity-testng/

Scenario 3: PNF Software Upgrade Using Ansible with EM Test Cases

Test Case IdTest CaseTest Status
TEST-CASE-1

UpgradePreCheck for PNF instance from SDNC to EM using LCM API

COMPLETE
TEST-CASE-2DownloadNESw for PNF instance from SDNC to EM using LCM APICOMPLETE
TEST-CASE-3ActivateNESw for PNF instance from SDNC to EM using LCM APICOMPLETE
TEST-CASE-4UpgradePostCheck for PNF instance from SDNC to EM using LCM APICOMPLETE
TEST-CASE-5Test PNF SW upgrade Workflow for PNF instance from SO to SDNC (using LCM API) to EM

COMPLETE

Details at Enhancement on PNF S/W Upgrade using Ansible.

Scenario 4: PNF Software Upgrade Using Netconf/Yang Interface with EM Test Cases

Test Case IdTest CaseTest Status
TEST-CASE-1Download NE SW for PNF instance 1 from CDS to EM using SS REST APICOMPLETE
TEST-CASE-2Activate NE SW for PNF instance 1 from CDS to EM using SS REST APICOMPLETE
TEST-CASE-3Download NE SW for PNF instance 2 from CDS to EM using SS REST APCOMPLETE
TEST-CASE-4Activate NE SW for PNF instance 2 from CDS to EM using SS REST APICOMPLETE
TEST-CASE-5Test PNF SW upgrade Workflow for PNF instance 1 from SO to CDS (using SS gRPC API) to EM

COMPLETE

Details at PNF software upgrade with Netconf/Yang interface with EM.

Reference

ONAP Controller Evolution Consideration - LCM APIs 

Discussion Materials

This section is to review slides for discussion.


PNF Software Upgrade Proposal for Scenario 1 Controller to PNF Interface

Version 2 with updates from Aug 8 2019 meeting

PNF SW Upgrade Proposal v2.pptx


Analysis of SO Instance Management API

ONAP-PNF-Software-Upgrade-SO-v0.1.docx

ONAP-PNF-Software-Upgrade-SO-v0.2.docx

SO API requirements in R6

Related Meeting Links

Meeting Schedule for Impacted Project Discussion

The meeting schedule is to present this use case slides to the impacted projects.

Planned DateRelated Project/UC Meeting HostOther
July 15SDC
July 11CDS
July 10Use case Realization
July 10Change Management
Oct 9SO