This is a continuation of the use case started in Casablanca: 5G - PNF Software Update
Background (R3 Casablanca)
In Casablanca, the UC leveraged the Ansible adaptor of ONAP controller to implement three S/W upgrade related operations for 5G PNFs. As an important feature the new workflow supports an External Controller (EC) in the execution of these operations. All these operations have shared the same LCM APIs with VNF S/W upgrade with PNF specific parameters passed in the API payloads. The corresponding DGs of LCM APIs are updated. The operations are:
- /operations/LCM:upgrade-pre-check
- /operations/LCM:upgrade-software
- /operations/LCM:upgrade-post-check
Dublin Scope
For Dublin, the target of this UC includes:
- 3GPP Software Management API alignment
- South-bound of SDNC: Extend upgrade-software operation by leveraging sub-operations from 3GPP (like download/install/activate).
- North-bound of SDNC: Rollback/fallback API support for 5G PNF
- Workflow support for PNF in-place SW upgrade in SO (stretch goal)
Presentations and Discussion Slides:
- Mar1-2019-ONAP PNF Software Upgrade Dublin.pptx
- Feb20 2019-ONAP Software Upgrade Dublin Targets.pptx
- 5G_UC_for_Dublin_PNF_Upgrade_Dec_20.pptx
- 5G_UC_for_Dublin_NETCONF_PNF_Upgrade_DDF.pptx
- 5G-UC-PNFSWUPDATE-Gapvs3GPP-20190226-v3.pptx
Related Meeting Links:
5G PNF Upgrades,https://zoom.us/j/519627903
[usecase] Platform Evolution for Use Case Realization w/ SO, AAI, DCAE, SDC, VID, SDNC,
https://zoom.us/j/723094623
[usecase] 5G Usecase Team, https://zoom.us/j/478423919
Development Status
Proposed Dublin scope presented Dec 20, 2018 to the 5G UC meeting.
| Project | PTL/Contancts | JIRA | Description | Status |
|---|---|---|---|---|
APPC SDNC CCSDK |
| |||
| VF-C | No Impact | |||
SO VID |
| |||
| Integration | Yang Xu | No impact | ||
| External Controller | Support for 3GPP API calls for sw download, install and activate. |
Project Impacts | Description | Links |
SDNC/CCSDK | Modify SDNC LCM action - rollback | |
complete rollback LCM action for PNF S/W upgrade | ||
create a DG for PNF S/W upgrade | ||
provide corresponding ansible playbook for rollback operation | ||
Extend PNF upgrade-software operation by leveraging sub-operations from 3GPP (like download/install/activate) | ||
External Controller | Support swFallback/download/install/activate operations | NA |
Requirements Impact
CCSDK → Changes in LCM.yang file
SDN-C → (1) New ansible playbooks, (2) New DG for rollback
EC → New substeps such as sw download, install and activate
API changes
- Yang model changes to current LCM:rollback action in CCSDK (mandatory fields in rollback action will be optional to make the LCM:rollback action more generic, optional output payload field is added)
- Definition of rollback input and output payloads for 5G PNF specific rollback
- Possible payload changes into existing API /operations/LCM:upgrade-software
- sw download, install and activate APIs in southbound of SDNC (to EC) as part of Ansible playbook for LCM:upgrade-software API.
Test cases and Status
Master Integration Test Page: Dublin Release Integration Testing Status
| # | Test Case Description | Test Status |
|---|---|---|
1 PreCheck test | Ensure LCM:upgrade-pre-check can be executed (north-bound of SDNC) | NOT TESTED |
2 SwUpgrade test | Ensure LCM:upgrade-software can be executed (north-bound of SDNC) | NOT TESTED |
3 PostCheck test | Ensure LCM:upgrade-post-check can be executed (north-bound of SDNC) | NOT TESTED |
| 4 SwRollback test | Ensure LCM:rollback can be executed (north-bound of SDNC) | NOT TESTED |
5 SwDownload | Ensure software download API can be executed (south-bound of SDNC to EC) | NOT TESTED |
6 SwInstall | Ensure software install API can be executed (south-bound of SDNC to EC) | NOT TESTED |
7 SwActivate | Ensure software activate API can be executed (south-bound of SDNC to EC) | NOT TESTED |