From 8a1564818d0db8aa22ff12549b63aa88352f5022 Mon Sep 17 00:00:00 2001 From: Yaoguang Wang Date: Fri, 30 Nov 2018 09:21:22 +0800 Subject: Add documentation for 5G PNF Software upgrade Issue-ID: INT-748 Change-Id: Ifa49ad0c52c40986237beff4f5f5800876bcace3 Signed-off-by: Yaoguang Wang --- docs/docs_5G_PNF_Software_Upgrade.rst | 56 +++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/docs_5G_PNF_Software_Upgrade.rst diff --git a/docs/docs_5G_PNF_Software_Upgrade.rst b/docs/docs_5G_PNF_Software_Upgrade.rst new file mode 100644 index 000000000..75977d8c8 --- /dev/null +++ b/docs/docs_5G_PNF_Software_Upgrade.rst @@ -0,0 +1,56 @@ +5G PNF Software Upgrade +---------------------------- + +Description +~~~~~~~~~~~ +The 5G PNF Software upgrade use case shows how users/network operators can modify the software running on an existing PNF. This use case is one aspect of Software Management. This could be used to update the PNF software to a newer or older version of software. + +The Casablanca 5G PNF Software Upgrade Use Case Wiki Page can be found here: https://wiki.onap.org/display/DW/5G+-+PNF+Software+Update + +How to Use +~~~~~~~~~~ +Upgrading PNF (instance) software requires the user/network operator to trigger the upgrade operation from the UI, e.g. VID or UUI. In Cacablanca, users need use ONAP Controllers GUI to trigger the LCM opeations, like pre-check, post-check and upgrade. After receiving the API requests, the ONAP controllers will communicate to the external controller(EC) through south-bound adaptors, which is Ansible in R3. + +Note that, both APPC and SDNC in R3 supported Ansible. Taking SDNC and Prechecking as an example, the steps are as follows: + +1) In ansible server container, prepare the ssh connection conditions to the external controller, both ssh key file and ansible inventory configuration; + +2) In sdnc controller container, update the dg configuration file: lcm-dg.properties. +For example: +:: +lcm.pnf.upgrade-pre-check.playbookname=ansible_huawei_precheck +lcm.pnf.upgrade-post-check.playbookname=ansible_huawei_postcheck +lcm.pnf.upgrade-software.playbookname=ansible_huawei_upgrade + +3) Login controller UI, access the pre-check LCM operation and send request. +Post upgrade-pre-check with the following request body: +:: +{ + "input": { + "common-header": { + "timestamp": "2018-10-10T09:40:04.244Z", + "api-ver": "2.00", + "originator-id": "664be3d2-6c12-4f4b-a3e7-c349acced203", + "request-id":"664be3d2-6c12-4f4b-a3e7-c349acced203", + "sub-request-id": "1", + "flags": { + "force" : "TRUE", + "ttl" : 60000 + } + }, + "action": "UpgradePreCheck", + "action-identifiers": { + "vnf-id":"5gDU0001" + }, + "payload": "{\"pnf-flag\":\"true\", \"pnf-name\": \"5gDU0001\",\"pnfId\": \"5gDU0001\", \"ipaddress-v4-oam\": \"EC_IP_address\",\"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r001\", \"Id\": \"10\", \"additionalData\":\"{}\"}"}} + +4) The HTTP API response code 200 and LCM retured code 400 (See APPC return code design specification) indicate success, otherwise failed. + +Test Status and Plans +~~~~~~~~~~~~~~~~~~~~~ +To see information on the status of the test see: https://wiki.onap.org/display/DW/5G+-+PNF+Software+Update+Test+Status + +Known Issues and Resolutions +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +None + -- cgit 1.2.3-korg