aboutsummaryrefslogtreecommitdiffstats
path: root/docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst
diff options
context:
space:
mode:
authorwangyaoguang <sunshine.wang@huawei.com>2020-04-01 13:12:21 +0000
committerBartek Grzybowski <b.grzybowski@partner.samsung.com>2020-04-03 13:54:43 +0000
commit008f9e82481a36b2ed29bb7e1aa770378eca1619 (patch)
tree4b964d5e7411fe75be6b4e25d058f5a1377fa41d /docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst
parentdc6c04cef47e971d7178604cae2cb80bb7b4cd14 (diff)
Add docs for PNF Software upgrade
It contains documentation for two sub-scenarios of PNF Software upgrade, enhancement on PNF SW upgrade using ansible and with netconf/yang interface with EM. Issue-ID: INT-1209 Signed-off-by: wangyaoguang <sunshine.wang@huawei.com> Change-Id: I6e1ad2464d9f0d607d5f7f14d8fb1c51afc90814
Diffstat (limited to 'docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst')
-rw-r--r--docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst29
1 files changed, 27 insertions, 2 deletions
diff --git a/docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst b/docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst
index 2c9ff294e..1482cb5d6 100644
--- a/docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst
+++ b/docs/docs_5G_PNF_Software_Upgrade_ansible_with_EM.rst
@@ -3,6 +3,31 @@
.. _docs_5g_pnf_software_upgrade_ansible_with_EM:
-===========================================================================
PNF Software Upgrade Scenario: Using Ansible protocol with EM
-=========================================================================== \ No newline at end of file
+-------------------------------------------------------------
+
+Software Upgrade Procedure
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+With this scenario, the pre-conditions are:
+
+* SO PNF software upgrade workflows are ready to use. For this scenario, the CONTROLLER_ACTOR is set for SDNC client for the API selection decision.
+* Service instantiation is completed, including PNF PnP. It means a PNF instance is in operation and is avaibale for ONAP (maybe via EMS).
+* ONAP Controller (SDNC and ansible server) and DMaaP are ready to use. It means necessary ansible connection and DMaaP topics are ready.
+* EMS has direct ansible interface to the ansible server. The underlying protocol is SSH.
+
+At run time, the service provider in R6 can use CLI to trigger the PNF in-place software upgrade procedure by selecting the existing PNF software upgrade workflow or uploading a custom workflow, as well as an identifier of a PNF instance, the target software version and optional json-formatted payload.
+
+Then the software upgrade workflow is executed as follows:
+
+a. SO sends request(s) with input {action, action-identifiers, common header, and optional payload} to SDNC API handler using traditional LCM API.
+b. SDNC API handler executes corresponding DG and sends requests to the ansible server.
+c. The ansible server executes ansible playbook with the EMS. Then EMS is responsible of software upgrade procedure of the selected PNF instance.
+d. Repeat above steps for each SO building block in the corresponding PNF software upgrade workflow.
+
+Test Status and Plans
+~~~~~~~~~~~~~~~~~~~~~
+
+To see information on the status of the test cases, please follow the link below:
+
+`Enhancement on PNF software upgrade using Ansible Test Status <https://wiki.onap.org/pages/viewpage.action?pageId=64007357#EnhancementonPNFS/WUpgradeusingAnsible-TestStatus>`_