Table of Contents
Table of Contents
Scenario Scope In Frankfurt
This scenario will complete the E2E procedure of PNF in-place SW upgrade case started from Casablanca (evolved in Dublin). The E2E procedure is VID→ SO→ Controller(SDNC/CCSDK)→Ansible Server→ EMS → PNF.
- Trigger by VID to upgrade speficific PNF instance's software
- Enhance SO to support PNF S/W upgrade workflow execution
- Add SO BBs to do precheck/downloadNESw/activateNESw/UpdateAAI/postcheck using SDNC client
Support LCM API for downloadNESw and activateNESw actions
Provide ansible playbooks for downloadNESw and activateNESw
- Enhance EMS emulator for integration test
Since this scenario started from Casanblanca, it is helpful to find more details completed in past releases with following link.
- In Casablanca: 5G - PNF Software Update
- In Dublin: 5G - PNF SW Upgrade (Casablanca carry-over items)
Procedure
Pre-conditions
- ONAP is ready to use, while min components are VID/SO/SDNC/CCSDK.
- PNF PnP is completed, and EMS ipaddress is strored in AAI within PNF Registration step, as ipaddressV4Oam.
- EMS (Emulator) is running, and SFTP (can be with EMS) is ready.
Upgrade procedure
- (1) In PNF pre-onboarding, operator delivers the PNF packages, including necessary ansible artifacts, to SDC. [playbook distribution is out of scope in this release]
- (2) In Sw Upgrade runtime, operator initiates the command, via VID or timer, to SO. (Before that, operator should design the upgrade workflow, or use the existing one).
- (3) SO executes the Sw upgrade task, like A&AI retrieval, and sends LCM requests to the controller.
- (4) Ansible Adaptor forwards requests to EMS via ansible server.
Sequence Diagram
Impacts
| Project/Component | Story |
|---|---|
SO | Support generic PNF workflow design |
SO | Support upgrade sw version at PNF instance level |
| SO | Align with SO building block for PNF Upgrade procedure 1) Create new SO BB – downloadNESw 2) Create new SO BB – activateNESw 3) Create new SO BB – update AAI 4) Update SO BB – preCheck and postCheck |
| SO | Support different controller decision points in SO |
| SDNC/CCSDK | Support LCM API for downloadNESw and activateNESw actions |
| SDNC/CCSDK | Provide ansible playbooks for downloadNESw and activateNESw |
| VNFRQTS | PNF Software Upgrade with ansible with EM |
| Integration | 1) EMS simulator extension 2) Integration document revision for PNF Sw Upgrade UC |
API Impacts Details
- LCM API of CCSDK:
| LCM API Abbre. | HTTP Method | URI | Yang Model Section | Request Example | Response Example | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| UpgradePreCheck* | POST | /operations/LCM:upgrade-pre-check |
|
| 400: Success
| |||||||||||||||||||||||||||
| UpgradePostCheck* | /operations/LCM:upgrade-post-check |
|
| 400: Success
| ||||||||||||||||||||||||||||
| DownloadNESw | /operations/LCM:download-n-e-sw |
|
| 400: Success
| ||||||||||||||||||||||||||||
| ActivateNESw | /operations/LCM:activate-n-e-sw |
|
| 400: Success
|
*: These LCM APIs are enhanced from R4/R5, and update the vnf-id field in action-identifiers to pnf-name in the request parameter.
The playbook-name in the payload of request is optional. If not set the playbook-name in the request, it will use the value in the config file /opt/onap/sdnc/data/properties/lcm-dg.properties of SDNC.
JIRA Status Tracking
| Jira Legacy | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Head Epic :
| Jira Legacy | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Test Status
| No | Test Case | Test Status |
|---|---|---|
| 1 | UpgradePreCheck for PNF instance from SDNC to EM using LCM API | COMPLETE |
| 2 | DownloadNESw for PNF instance from SDNC to EM using LCM API | COMPLETE |
| 3 | ActivateNESw for PNF instance from SDNC to EM using LCM API | COMPLETE |
| 4 | UpgradePostCheck for PNF instance from SDNC to EM using LCM API | COMPLETE |
| 5 | Test PNF SW upgrade Workflow for PNF instance from SO to SDNC (using LCM API) to EM | COMPLETE |
Preparation
1. Add topics SDNC-LCM-READ and SDNC-LCM-WRITE to DMaaP if they don't exist.
curl -s -H "Content-Type: application/json" -X POST http://message-router.onap:30227/topics/create -d ' { |
| curl -s -H "Content-Type: application/json" -X POST http://message-router.onap:30227/topics/create -d ' { "topicName": "SDNC-LCM-WRITE", "partitionCount": "1", "replicationCount": "1" }' |
2. Add the following line in the file in /opt/ansible-server/Playbooks/Ansible_inventory in ansible-server container:
192.168.35.83 ansible_connection=ssh ansible_ |
port=60032 ansible_user=admin ansible_ssh_private_key_file=/home/ansible/.ssh/ |
ems.key |
Where ssh_key_file is ems.key is the private key of SSH user admin at host ems-swm.Hostname ems-swm is the at EMS Simulator.
Detailed Description of Integration Testcases and Results
| Test Command |
|---|
| curl -s -k -u "admin:Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U" -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://sdnc.onap:30202/restconf/operations/LCM:upgrade-pre-check -d @upgrade-pre-check-input.json | python -m json.tool |
| Contents of upgrade-pre-check-input.json |
|---|
{ |
"output": {
"payload": "{\"result\": \"Success\"}",
3. Initial PNF 5gDU0001 entry in AAI:
| { "pnf-name": "5gDU0001", "pnf-id": "5gDU0001", "ipaddress-v4-oam": "192.168.35.83", "sw-version": "v1", "in-maint": false, "resource-version": "1584873329418" } |
Where Sw Version of PNF 5gDU0001 is "v1".
4. Add some entries to SO catalogdb:
use catalogdb; insert into pnf_resource set MODEL_UUID='f50f34be-9aa7-4a03-aa12-fd29e5f27538', MODEL_VERSION='1.0'; insert into pnf_resource_customization set MODEL_CUSTOMIZATION_UUID='c57939f8-ee46-4700-aa3a-60374507d94f', MODEL_INSTANCE_NAME='TestPnf', PNF_RESOURCE_MODEL_UUID='f50f34be-9aa7-4a03-aa12-fd29e5f27538', CONTROLLER_ACTOR='sdnc'; insert into pnf_resource_customization_to_service set SERVICE_MODEL_UUID='296d49aa-236a-4920-a395-5620df09e765', RESOURCE_MODEL_CUSTOMIZATION_UUID='c57939f8-ee46-4700-aa3a-60374507d94f'; insert into workflow (ARTIFACT_UUID, ARTIFACT_NAME, NAME, VERSION, DESCRIPTION, RESOURCE_TARGET, SOURCE) values ('245a0bca-3816-45c6-9270-1de25d27fc56', 'PNFSoftwareUpgrade.bpmn', 'PNFSoftwareUpgrade', '1.0', 'PNF Software Upgrade Test', 'pnf', 'native'); |
Detailed Description of Integration Testcases and Results
| Test case ID | 1 | ||||
|---|---|---|---|---|---|
| Name | UpgradePreCheck for PNF instance from SDNC to EM using LCM API | ||||
| Description | UpgradePreCheck for PNF instance from SDNC to EM using LCM API | ||||
| Release | Frankfurt | ||||
| Pre-conditions | |||||
| Testing Steps |
|
|
|
|
"sub-request
|
|
|
}
|
|
"code": 400,
"message
|
|
}
}
}
| Test Command |
|---|
| curl -s -k -u "admin:Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U" -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://sdnc.onap:30202/restconf/operations/LCM:download-n-e-sw -d @download-n-e-sw-input.json | python -m json.tool |
"input": {
"action": "DownloadNESw",
"action-identifiers": {
"pnf-name": "5gDU0001"
},
"common-header": {
"api-ver": "2.00",
"flags": {
"force": "FALSE",
"mode": "NORMAL",
"ttl": 65000
},
"originator-id": "MSO",
"request-id": "6ca0df6f-85d5-40d0-b577-58fc6963126e
|
|
|
|
|
}
}
"output": {
"payload": "{\"result\": \"Success\"}",
| |
| Conclusion (Pass/Fail) | Pass |
| Test Lab |
| Test case ID | 2 | ||||
|---|---|---|---|---|---|
| Name | DownloadNESw for PNF instance from SDNC to EM using LCM API | ||||
| Description | DownloadNESw for PNF instance from SDNC to EM using LCM API | ||||
| Release | Frankfurt | ||||
| Pre-conditions | |||||
| Testing Steps |
|
|
|
|
"sub-request
|
|
|
}
|
|
"code": 400,
"message
|
|
}
}
}
| Test Command |
|---|
| curl -s -k -u "admin:Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U" -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://sdnc.onap:30202/restconf/operations/LCM:activate-n-e-sw -d @activate-n-e-sw-input.json | python -m json.tool |
"input": {
"action": "ActivateNESw",
"action-identifiers": {
"pnf-name": "5gDU0001"
},
"common-header": {
"api-ver": "2.00",
"flags": {
"force": "FALSE",
"mode": "NORMAL",
"ttl": 65000
}
|
|
|
|
|
|
|
|
|
|
"timestamp": "2020-03-10T08:16:29.255Z
|
|
|
|
}
}
| Response of SDNC |
|---|
{ |
| Test Command |
|---|
| curl -s -k -u "admin:Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U" -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://sdnc.onap:30202/restconf/operations/LCM:upgrade-post-check -d @upgrade-post-check-input.json | python -m json.tool |
| Contents of upgrade-post-check-input.json |
|---|
{ |
| Response of SDNC |
|---|
{ |
| Test Command |
|---|
| curl -s -u "InfraPortalClient:password1$" -H "Content-Type: application/json" -H "Accept: application/json" -H "X-ONAP-RequestID: a903813b-b9d7-446f-a9dd-1bfb7c8d4228" -H "X-ONAP-PartnerName: SO-REST" -H "X-RequestorID: so-rest" -X POST http://so.onap:30277/onap/so/infra/instanceManagement/v1/serviceInstances/25c651cb-4ddb-4755-9aea-42e36ea34442/pnfs/5gDU0001/workflows/245a0bca-3816-45c6-9270-1de25d27fc56 -d @PNFSoftwareUpgrade-sdnc.json | python -m json.tool |
"requestDetails": {
"modelInfo": {
"modelUuid": "296d49aa-236a-4920-a395-5620df09e765"
},
"requestInfo": {
"instanceName": "453b15b7-55c2-4f82-b80d-0218abf2b573"
},
"requestParameters": {
"userParams": [
{
"name": "pnfName",
"value": "5gDU0001"
},
{
"name": "targetSoftwareVersion",
"value": "v2"
}
],
"payload": "{\"ipaddressV4Oam\": \"ems-swm\", \"oldSwVersion\": \"v1\", \"preCheckRuleName\": \"r101\", \"preCheckAdditionalData
| |
| Conclusion (Pass/Fail) | Pass |
| Test Lab |
| Test case ID | 3 | ||||||
|---|---|---|---|---|---|---|---|
| Name | ActivateNESw for PNF instance from SDNC to EM using LCM API | ||||||
| Description | ActivateNESw for PNF instance from SDNC to EM using LCM API | ||||||
| Release | Frankfurt | ||||||
| Pre-conditions | |||||||
| Testing Steps |
| ||||||
| Conclusion (Pass/Fail) | Pass | ||||||
| Test Lab |
| Test case ID | 4 | ||||||
|---|---|---|---|---|---|---|---|
| Name | UpgradePostCheck for PNF instance from SDNC to EM using LCM API | ||||||
| Description | UpgradePostCheck for PNF instance from SDNC to EM using LCM API | ||||||
| Release | Frankfurt | ||||||
| Pre-conditions | |||||||
| Testing Steps |
| ||||||
| Conclusion (Pass/Fail) | Pass | ||||||
| Test Lab |
| Test case ID | 5 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Name | Test PNF SW upgrade Workflow for PNF instance from SO to SDNC (using LCM API) to EM | ||||||||||||
| Description | Test PNF SW upgrade Workflow for PNF instance from SO to SDNC (using LCM API) to EM | ||||||||||||
| Release | Frankfurt | ||||||||||||
| Pre-conditions | |||||||||||||
| Testing Steps | NOTE: Befor testing this case, reset the EMS Simulator to initial status.
Retrieve the status of the workflow:
While the requestStatus is "IN_PROGRESS", then wait a minute to retrieve the status of workflow again and agiain, until the requestStatus is "COMPLETED":
|
|
|
|
|
|
}
}
}
While the requestStatus is "COMPLETED", then retrieve the Sw Version of PNF 5gDU0001 in AAI:
The Sw Version of PNF 5gDU0001 in AAI is upgraded to "v2". | |||||
| Conclusion (Pass/Fail) | Pass | ||||
| Test Lab |