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
- With the support of an EM
- Ansible protocol only
- Plan to use LCM API with existing SO building blocks
- Impacts on SDNC only (not E2E solution yet)
More details, 5G - PNF Software Update & 5G - PNF SW Upgrade (Casablanca carry-over items)
PNF Software Upgrade Scenarios
There are 4 scenarios are proposed:
- Using direct Netconf/Yang interface with PNF
- Enable service level LCM operations
- Using Ansible protocol with EM
- 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
PROJECT | PTL | User Story / Epic | Requirement |
A&AI | |
|
|
AAF | |
|
|
APPC | |
|
|
CLAMP | |
|
|
CC-SDK | | Epic #1: PNF Software Upgrade | - Support LCM API / self service API for downloadNESw and activateNESw actions
- Provide CDS blueprint for downloadNESw and activateNESw (Test only)
|
DCAE | |
|
|
DMaaP | |
|
|
External API | |
|
|
MODELING | |
|
|
Multi-VIM / Cloud | |
|
|
OOF | |
|
|
POLICY | | |
|
PORTAL | |
|
|
SDN-C | | Epic #1: PNF Software Upgrade | - Support LCM API for downloadNESw and activateNESw actions
- Provide ansible playbooks for downloadNESw and activateNESw (Test only)
|
SDC | | Epic #1: PNF Software Upgrade | - support generic workflow design
- CBA association enhancement to support PNF upgrade. Impacts on PNFD AID model
- CBA association enhancement to support VNF upgrade. Impacts on VNFD AID model
|
SO | | Epic #1: PNF Software Upgrade | - Support generic PNF CM workflow, including SO building block shall be extended to support PNF LCM actions
- SO API extension: PNF software upgrade with target software version
- SO BB for downloadNESw, activateNESw, preCheck, postCheck
- API (LCM or CDS SS) selection within the same BB
|
VID | | Epic #1: PNF Software Upgrade | - trigger PNF Sw upgrade workflow, providing corresponding parameter values
|
VNFRQTS | | Epic #1: PNF Software Upgrade | update the PNF/VNF upgrade requirements |
VNF-SDK | |
|
|
CDS | | Epic #1: PNF Software Upgrade | - Provide CDS blueprint for downloadNESw and activateNESw
- API (LCM or CDS SS) selection within the same BB
|
Integration | Brian Freeman |
|
|
List of PTLs: Approved Projects
Requirements Tickets
key |
summary |
type |
created |
updated |
due |
assignee |
reporter |
priority |
status |
resolution |
Development Tickets
PNF software upgrade with direct Netconf/Yang interface with PNF
key |
summary |
type |
created |
updated |
assignee |
reporter |
priority |
status |
resolution |
subtasks |
fixversions |
Enable service level LCM operations
key |
summary |
type |
created |
updated |
assignee |
reporter |
priority |
status |
resolution |
subtasks |
fixversions |
Enhancement on the PNF upgrade using Ansible protocol
key |
summary |
type |
created |
updated |
due |
assignee |
reporter |
priority |
status |
resolution |
PNF software upgrade with Netconf/Yang interface with EM
key |
summary |
type |
created |
updated |
due |
assignee |
reporter |
priority |
status |
resolution |
1 | There should be a test case for each item in the sequence diagram | |
2 | create additional requirements as needed for each discreet step | |
3 | Test cases should cover entire Use Case | |
4 | Test Cases should include enough detail for testing team to implement the test | |
PNF software upgrade with direct Netconf/Yang interface with PNF
PNF Software Upgrade Using direct NETCONF/YANG interface with PNF Test Cases
INT-1308
-
Getting issue details...
STATUS
Test Case Id | Test Case | Test Type | Status |
---|
TEST-CASE-1 | Test Check in SDNC certificates to connect node are properly installed | Integration(robot) | COMPLETE |
TEST-CASE-2 | Test Blue print archive is properly uploaded to blueprint-processor | Integration(robot) | COMPLETE |
TEST-CASE-3 | Test resource package and service is successfully distributed from SDC to SO | Integration(robot) | COMPLETE |
TEST-CASE-4 | Test all the pnf workflows are successfully fetched from SO | Integration(robot) | COMPLETE |
TEST-CASE-5 | Test Service instantiation is triggered from VID to SO and status is COMPLETED for preparation(Download) workflow | Integration(robot) | COMPLETE |
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 | Integration(robot) | COMPLETE |
TEST-CASE-7 | Test Service instantiation is triggered from VID to SO and status is COMPLETED for software upgrade workflow | Integration(robot) | COMPLETE |
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 | Integration(robot) | COMPLETE |
TEST-CASE-9 | Verify 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.
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 |
Enable service level LCM operations
Test Case Id | Test Case | Test Type | Status |
---|
TEST-CASE-1 | Test Onboarding of PNF Package with non-mano Software Information in SDC Sanity-API test | Sanity | Local SDC deployment: COMPLETE SDC Daily API Sanity: COMPLETE |
TEST-CASE-2 | Test Onboarding of PNF Package with non-mano Software Information in SDC GUI | Manual | Local SDC deployment: COMPLETE |
TEST-CASE-3 | Test Onboarding of PNF Package with non-mano Software Information in SDC Sanity-UI test | Sanity | Local SDC deployment: COMPLETE SDC Daily UI Sanity: COMPLETE |
Test Types:
- Sanity-API: automated sanity tests for backend SDC APIs (SDC Sanity);
- Sanity-UI: automated sanity tests for SDC GUI;
- Manual: manual test in SDC UI (either local SDC or ONAP deployment);
- End to End (E2E): end to end test with other interested ONAP components.
Test Cases Details
Test Case ID | TEST-CASE-1 |
---|
Test Case Name | Test Onboarding of PNF Package with non-mano Software Information in SDC Sanity-API test |
---|
Description | The test will onboard PNF Packages with non-mano Software Information in the SDC Sanity API test flow |
---|
Release | Frankfurt |
---|
Preconditions | Local SDC or ONAP deployment available and running |
---|
Testing Steps | # | Step | Expected Result |
---|
1 | Run SDC sdc-api-tests | sdc-api-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) | Local SDC deployment: COMPLETE SDC Daily API Sanity: COMPLETE |
---|
Testing Lab | Local 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 Name | Test Onboarding of PNF Package with non-mano Software Information in SDC GUI |
---|
Description | Manually onboard the PNF Package with non-mano Software Information in the SDC GUI, creating a VSP and importing as a ONAP PNF Resource. |
---|
Release | Frankfurt |
---|
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 | # | Step | Expected Result |
---|
1 | Access SDC GUI as a Designer. | SDC Home screen is shown. | 2 | Go to the Onboard Workspace . | Onboard workspace is shown. | 3 | Click on "CREATE NEW VSP". | "New Software Product" popup is shown. | 4 | Fill in the "New Software Product" required information, selecting "Network Package" as the Onboarding Procedure and click on create. | The VSP Overview page is shown. | 5 | In 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. | 6 | In the VSP attachment validation, click on the Submit button. | A "Commit & Submit" popup is shown. | 7 | Fill the "Commit & Submit" popup with any comment and click in the "Commit & Submit" button. | A "Submit Succeeded" information is shown. | 8 | Close the "Submit Succeeded" popup and go to the Home workspace. | SDC Home screen is shown. | 9 | Hover your mouse to the IMPORT square and click in "Import VSP". | A "Import VSP" modal is shown with the SDC VSP list. | 10 | Search for the created VSP. | The created VSP is shown in the VSP list. | 11 | Click on the VSP and then in the Download VSP link. | The VSP CSAR package is downloaded. | 12 | Open 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. | 13 | Go 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. | 14 | Click on the "Create" button to create the resource. | A creation confirmation message is shown. | 15 | On the left panel, click on the "Properties Assignment". | The "Properties Assignment" page is shown. | 16 | Verify 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 Lab | Local SDC deployment |
---|
Test Case ID | |
---|
Test Case Name | Test Onboarding of PNF Package with non-mano Software Information in SDC Sanity-UI test |
---|
Description | The test will onboard the PNF Package with non-mano Software Information in the UI SDC Sanity test flow |
---|
Release | Frankfurt |
---|
Preconditions | Local SDC or ONAP deployment available and running |
---|
Testing Steps |
# | Step | Expected Result |
---|
1 | Run SDC sdc-ui-tests | sdc-ui-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) | |
---|
Testing Lab | Local SDC deployment, SDC Daily UI Sanity run https://jenkins.onap.org/view/sdc/job/sdc-master-csit-uiSanity-testng/ |
---|
Enhancement on the PNF upgrade using Ansible protocol
PNF Software Upgrade Using Ansible with EM Test Cases
Test Case Id | Test Case | Test Status |
---|
TEST-CASE-1 | UpgradePreCheck for PNF instance from SDNC to EM using LCM API | COMPLETE |
TEST-CASE-2 | DownloadNESw for PNF instance from SDNC to EM using LCM API | COMPLETE |
TEST-CASE-3 | ActivateNESw for PNF instance from SDNC to EM using LCM API | COMPLETE |
TEST-CASE-4 | UpgradePostCheck for PNF instance from SDNC to EM using LCM API | COMPLETE |
TEST-CASE-5 | Test 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.
PNF software upgrade with Netconf/Yang interface with EM
PNF Software Upgrade Using Netconf/Yang Interface with EM Test Cases
Test Case Id | Test Case | Test Status |
---|
TEST-CASE-1 | Download NE SW for PNF instance 1 from CDS to EM using SS REST API | COMPLETE |
TEST-CASE-2 | Activate NE SW for PNF instance 1 from CDS to EM using SS REST API | COMPLETE |
TEST-CASE-3 | Download NE SW for PNF instance 2 from CDS to EM using SS REST AP | COMPLETE |
TEST-CASE-4 | Activate NE SW for PNF instance 2 from CDS to EM using SS REST API | COMPLETE |
TEST-CASE-5 | Test 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
Meeting Schedule for Impacted Project Discussion
The meeting schedule is to present this use case slides to the impacted projects.
Planned Date | Related Project/UC | Meeting Host | Other |
---|
July 15 | SDC | |
|
July 11 | CDS | |
|
July 10 | Use case Realization | |
|
July 10 | Change Management | |
|
Oct 9 | SO | |
|