Update 5G PNF PnP test documentation about information on how to use NF Simulator 49/120649/3
authorKrzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com>
Mon, 19 Apr 2021 15:17:17 +0000 (17:17 +0200)
committerMarcin Przybysz <marcin.przybysz@nokia.com>
Tue, 20 Apr 2021 11:43:34 +0000 (11:43 +0000)
Update 5G PNF PnP test documentation about information on how to use NF Simulator

Issue-ID: INT-1869
Signed-off-by: Krzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com>
Change-Id: Idf5d8c724d5c9eb32618e75a06cdda55c1b29aaf

docs/docs_5g_pnf_pnp.rst

index ba1e33a..7807062 100644 (file)
@@ -8,11 +8,6 @@
 5G - PNF Plug and Play
 ----------------------
 
-Source files
-~~~~~~~~~~~~
-
-- Base PnP PNF Simulator docker compose file: https://gerrit.onap.org/r/gitweb?p=integration/simulators/pnf-simulator.git;a=blob_plain;f=pnfsimulator/docker-compose.yml;hb=refs/heads/master
-
 Description
 ~~~~~~~~~~~
 
@@ -20,16 +15,66 @@ The PNF Plug and Play is a procedure that is executed between a PNF and ONAP. In
 
 **Useful Links**
 
-- `5G - PNF Plug and Play use case documentation <https://wiki.onap.org/display/DW/5G+-+PNF+Plug+and+Play>`_
-- `5G - PNF Plug and Play - Integration Test Cases <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases>`_
-- `Instruction how to setup and use PnP PNF Simulator <https://gerrit.onap.org/r/gitweb?p=integration/simulators/pnf-simulator.git;a=blob_plain;f=pnfsimulator/README.md;hb=refs/heads/master>`_
-- `PnP PNF Simulator git repository <https://gerrit.onap.org/r/gitweb?p=integration/simulators/pnf-simulator.git;a=summary>`_
+1. `5G - PNF Plug and Play use case documentation <https://wiki.onap.org/display/DW/5G+-+PNF+Plug+and+Play>`_
+2. `5G - PNF Plug and Play - Integration Test Cases <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases>`_
+3. Instruction how to setup and use VES CLinet from :ref:`NF Simulator <nf_simulator>`.
 
 How to Use
 ~~~~~~~~~~
 
-1) Create and distribute service model which contains PNF
-2) Create service for PNF and wait for PNF Ready message in DmaaP topic
-3) Send PNF Registartion request from PnP PNF Simualtor and finish registration
+1. Create and distribute service model which contains PNF
+2. Create service for PNF and wait for PNF Ready message in DmaaP topic
+3. Send PNF Registartion request from NF Simualtor (VES Client) and finish registration
+
+Below is present an example of event that need to be send to VES Client in order to trigger registration event from VES Client to ONAP VES Collector.
+There is need to fill following values in example json with proper values:
+
+1. dcae-ves-collector-host-name
+2. dcae-ves-collector-port
+3. sourceName - Identifier of this Pnf information element. It is the first three letters of the Vendor and the PNF serial number.
+   This is a unique identifier for the PNF instance. It is also referred to as the Correlation ID.
+4. oamV4IpAddress - This is the IP address (IPv4) for the PNF itself. This is the IPv4 address that the PNF itself can be accessed at.
+5. oamV6IpAddress - This is the IP address (IPv6) for the PNF itself. This is the IPv6 address that the PNF itself can be accessed at.
+
+::
+
+   {
+     "vesServerUrl": "https://<dcae-ves-collector-host-name>:<dcae-ves-collector-port>/eventListener/v7",
+     "event": {
+       "event": {
+         "commonEventHeader": {
+           "startEpochMicrosec": 1538407540940,
+           "sourceId": "val13",
+           "eventId": "registration_38407540",
+           "nfcNamingCode": "oam",
+           "internalHeaderFields": {},
+           "eventType": "pnfRegistration",
+           "priority": "Normal",
+           "version": "4.0.1",
+           "reportingEntityName": "VEN6061ZW3",
+           "sequence": 0,
+           "domain": "pnfRegistration",
+           "lastEpochMicrosec": 1538407540940,
+           "eventName": "pnfRegistration",
+           "vesEventListenerVersion": "7.0.1",
+           "sourceName": "<sourceName>",
+           "nfNamingCode": "gNB"
+         },
+         "pnfRegistrationFields": {
+           "unitType": "val8",
+           "serialNumber": "6061ZW3",
+           "pnfRegistrationFieldsVersion": "2.0",
+           "manufactureDate": "1538407540942",
+           "modelNumber": "val6",
+           "lastServiceDate": "1538407540942",
+           "unitFamily": "BBU",
+           "vendorName": "VENDOR",
+           "oamV4IpAddress": "<oamV4IpAddress>,
+           "oamV6IpAddress": "<oamV6IpAddress>",
+           "softwareVersion": "val7"
+         }
+       }
+     }
+   }
+
 
-See <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases>`_ for details.