You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

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.

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/ComponentStory

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 MethodURIYang Model SectionRequest ExampleResponse Example
UpgradePreCheck*POST/operations/LCM:upgrade-pre-check
rpc upgrade-pre-check {
    description "An operation to check that the VNF has the correct software version needed for a software upgrade.";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
       }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory true;
                }
    }
}
{
  "input": {
    "action": "UpgradePreCheck",
    "action-identifiers": {
      "pnf-name": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-03-15T09:07:58.255Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"192.168.35.83\", \"playbook-name\": \"ansible_huawei_precheck\", \"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r001\", \"additionalData\":\"{}\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request  f0f45105-1a51-4592-a31b-f178d5eb4638 finished with Result = success, Message = FINISHED"
        }
    }
}
UpgradePostCheck*/operations/LCM:upgrade-post-check
rpc upgrade-post-check {
    description "An operation to check the VNF upgrade has been successful completed and all processes are running properly.";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
       }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory true;
                     }
    }
}
{
  "input": {
    "action": "UpgradePostCheck",
    "action-identifiers": {
      "pnf-name": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-02-23T09:07:58.255Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"192.168.35.83\", \"playbook-name\": \"ansible_huawei_postcheck\", \"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r102\", \"additionalData\":\"{}\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request  c1c14dee-a80d-40b8-800a-9216a27c7d1c finished with Result = success, Message = FINISHED"
        }
    }
}
DownloadNESw/operations/LCM:download-n-e-sw
rpc download-n-e-sw {
    description "An operation to download NE software";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
        }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory true;
        }
    }
}
{
  "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": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-10-19T10:20:16.125Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"192.168.35.83\", \"playbook-name\": \"ansible_huawei_downloadnesw\", \"swToBeDownloaded\": [{\"swLocation\": \"http://192.168.35.96:10080/ran_du_pkg1-v2.zip\", \"swFileSize\": 353, \"swFileCompression\": \"ZIP\", \"swFileFormat\": \"binary\"}]}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request 29cc5afd-082f-49be-bb52-3e96b178480c finished with Result = success, Message = FINISHED"
        }
    }
}
ActivateNESw/operations/LCM:activate-n-e-sw
rpc activate-n-e-sw {
    description "An operation to activate NE software";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
        }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory true;
        }
    }
}
{
  "input": {
    "action": "ActivateNESw",
    "action-identifiers": {
      "pnf-name": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-10-19T10:25:28.116Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"192.168.35.83\", \"playbook-name\": \"ansible_huawei_activatenesw\", \"swVersionToBeActivated\": \"v2\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request 0af55193-8177-41a7-b927-78646be6250b finished with Result = success, Message = FINISHED"

        }
    }
}

*: 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

Key Summary T Created Updated Due Assignee Reporter P Status Resolution
Refresh


Test Status

NoTest CaseTest Status
1

UpgradePreCheck for PNF instance from SDNC to EM using LCM API

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

COMPLETE

With Exception: WF was executed as expected (SW version was changed) but not right response from SO.


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 '

{
  "topicName": "SDNC-LCM-READ",
  "partitionCount": "1",
  "replicationCount": "1"
}'

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:

ems-swm ansible_connection=ssh ansible_ssh_user=admin ansible_ssh_private_key_file=/home/ansible/.ssh/ssh_key_file

Where ssh_key_file is private key of SSH user admin at host ems-swm.

Hostname ems-swm is the EMS Simulator.


Detailed Description of Integration Testcases and Results

Test case ID1
NameUpgradePreCheck for PNF instance from SDNC to EM using LCM API
DescriptionUpgradePreCheck for PNF instance from SDNC to EM using LCM API
ReleaseFrankfurt
Pre-conditions
Testing Steps


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

{
  "input": {
    "action": "UpgradePreCheck",
    "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",
      "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
      "timestamp": "2020-03-10T08:16:29.255Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"ems-swm\", \"playbook-name\": \"ansible_huawei_precheck\", \"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r101\", \"additionalData\": \"{}\"}"
  }
}

Response of SDNC

{
  "output": {
      "payload": "{\"result\": \"Success\"}",
      "common-header": {
          "api-ver": "2.00",
          "originator-id": "MSO",
          "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
          "request-id": "6ca0df6f-85d5-40d0-b577-58fc6963126e"
      },
      "status": {
          "code": 400,
          "message": "Ansible Request  31c7f666-6729-4b3e-8462-b58fc9bd6109 finished with Result = success, Message = FINISHED"
      }
  }
}

Conclusion (Pass/Fail)Pass
Test Lab
Test case ID2
NameDownloadNESw for PNF instance from SDNC to EM using LCM API
DescriptionDownloadNESw for PNF instance from SDNC to EM using LCM API
ReleaseFrankfurt
Pre-conditions
Testing Steps


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


Contents of download-n-e-sw-input.json

{
  "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",
      "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
      "timestamp": "2020-03-10T08:16:29.255Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"ems-swm\", \"playbook-name\": \"ansible_huawei_downloadnesw\", \"swToBeDownloaded\": [{\"swLocation\": \"http://192.168.35.96:10080/ran_du_pkg1-v2.zip\", \"swFileSize\": 353, \"swFileCompression\": \"ZIP\", \"swFileFormat\": \"binary\"}]}"
  }
}

Response of SDNC

{
  "output": {
      "payload": "{\"result\": \"Success\"}",
      "common-header": {
          "api-ver": "2.00",
          "originator-id": "MSO",
          "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
          "request-id": "6ca0df6f-85d5-40d0-b577-58fc6963126e"
      },
      "status": {
          "code": 400,
          "message": "Ansible Request  df8bcb3c-7cdf-47fb-969b-480e16b022cd finished with Result = success, Message = FINISHED"
      }
  }
}

Conclusion (Pass/Fail)Pass
Test Lab
Test case ID3
NameActivateNESw for PNF instance from SDNC to EM using LCM API
DescriptionActivateNESw for PNF instance from SDNC to EM using LCM API
ReleaseFrankfurt
Pre-conditions
Testing Steps


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
Contents of activate-n-e-sw-input.json

{
  "input": {
    "action": "ActivateNESw",
    "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",
      "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
      "timestamp": "2020-03-10T08:16:29.255Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"ems-swm\", \"playbook-name\": \"ansible_huawei_activatenesw\", \"swVersionToBeActivated\": \"v2\"}"
  }
}


Response of SDNC

{
  "output": {
      "payload": "{\"result\": \"Success\"}",
      "common-header": {
          "api-ver": "2.00",
          "originator-id": "MSO",
          "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
          "request-id": "6ca0df6f-85d5-40d0-b577-58fc6963126e"
      },
      "status": {
          "code": 400,
          "message": "Ansible Request  ef19757f-e2e2-4902-8fa1-8d05eef65109 finished with Result = success, Message = FINISHED"
      }
  }
}

Conclusion (Pass/Fail)Pass
Test Lab
Test case ID4
NameUpgradePostCheck for PNF instance from SDNC to EM using LCM API
DescriptionUpgradePostCheck for PNF instance from SDNC to EM using LCM API
ReleaseFrankfurt
Pre-conditions
Testing Steps


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

{
  "input": {
    "action": "UpgradePostCheck",
    "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",
      "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
      "timestamp": "2020-03-10T08:16:29.255Z"
    },
    "payload": "{\"ipaddress-v4-oam\": \"ems-swm\", \"playbook-name\": \"ansible_huawei_postcheck\", \"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r102\", \"additionalData\": \"{}\"}"
  }
}


Response of SDNC

{
  "output": {
      "payload": "{\"result\": \"Success\"}",
      "common-header": {
          "api-ver": "2.00",
          "originator-id": "MSO",
          "sub-request-id": "3013c12f-46d6-4f42-86cc-6658f8e62efd",
          "request-id": "6ca0df6f-85d5-40d0-b577-58fc6963126e"
      },
      "status": {
          "code": 400,
          "message": "Ansible Request  19517852-643e-4c15-9d28-bdd53e9c23a1 finished with Result = success, Message = FINISHED"
      }
  }
}

Conclusion (Pass/Fail)Pass
Test Lab
Test case ID5
NameTest PNF SW upgrade Workflow for PNF instance from SO to SDNC (using LCM API) to EM
DescriptionTest PNF SW upgrade Workflow for PNF instance from SO to SDNC (using LCM API) to EM
ReleaseFrankfurt
Pre-conditions
Testing Steps


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
Contents of request body

{
  "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\": \"{}\", \"preCheckPlaybook\": \"ansible_huawei_precheck\", \"swToBeDownloaded\": [{\"swLocation\": \"http://192.168.35.96:10080/ran_du_pkg1-v2.zip\", \"swFileSize\": 353, \"swFileCompression\": \"ZIP\", \"swFileFormat\": \"binary\"}], \"downloadNESwPlaybook\": \"ansible_huawei_downloadnesw\", \"activateNESwPlaybook\": \"ansible_huawei_activatenesw\", \"postCheckRuleName\": \"r102\", \"postCheckAdditionalData\": \"{}\", \"postCheckPlaybook\": \"ansible_huawei_postcheck\"}"
    }
  }
}

Conclusion (Pass/Fail)
Test Lab
  • No labels