| krzysztof kuzmicki | 55eb2e1 | 2018-11-29 16:35:56 +0100 | [diff] [blame] | 1 | 5G - PNF Plug and Play |
| 2 | ---------------------- |
| 3 | |
| 4 | Source files |
| 5 | ~~~~~~~~~~~~ |
| 6 | |
| 7 | - Base PnP PNF Simulator heat template file: https://git.onap.org/integration/tree/test/mocks/pnfsimulator/deployment/PnP_PNF_sim_heat_template_Ubuntu_16_04.yml |
| 8 | |
| 9 | Description |
| 10 | ~~~~~~~~~~~ |
| 11 | |
| 12 | The PNF PnP flow is a method, which allows to register within ONAP/AAI a PNF resource instance. |
| 13 | This PNF resource instance is correlated with an existing service instance. |
| 14 | PNF Plug and Play is used to register a PNF when it comes on-line. |
| 15 | This use case is intended to be applicable to a variety of PNFs such as routers and 5G base stations. |
| 16 | The steps and descriptions have been drafted to be as general as possible and to be applicable |
| 17 | to a relatively wide variety of PNFs. However, the use case was originally developed with a consideration |
| 18 | for 5G PNF Distributed Units (DU). |
| 19 | |
| 20 | **Useful Links** |
| 21 | |
| 22 | - `5G - PNF Plug and Play use case documentation <https://wiki.onap.org/display/DW/5G+-+PNF+Plug+and+Play>`_ |
| 23 | - `5G - PNF Plug and Play - Integration Test Cases <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases>`_ |
| 24 | - `5G - PNF Plug and Play test cases status for Casablanca release <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Test+Status>`_ |
| 25 | - `Instruction how to setup PnP PNF Simulator <https://wiki.onap.org/display/DW/PnP+PNF+Simulator>`_ |
| 26 | |
| 27 | How to Use |
| 28 | ~~~~~~~~~~ |
| 29 | |
| 30 | 1) `Create and distribute service model which contains PNF <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases#id-5G-PNFPnP-IntegrationTestCases-CreateanddistributeservicewhichcontainsPNF>`_ |
| 31 | 2) `Create service for PNF and wait for PNF Ready message in DmaaP topic <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases#id-5G-PNFPnP-IntegrationTestCases-PNFReady>`_ |
| 32 | 3) `Send PNF Registartion request from PnP PNF Simualtor and finish registration <https://wiki.onap.org/display/DW/5G+-+PNF+PnP+-+Integration+Test+Cases#id-5G-PNFPnP-IntegrationTestCases-PNFregistrationacceptingwhenAAIentrycreatedinadvance>`_ |
| 33 | |
| 34 | |
| 35 | Known Issues and Resolutions |
| 36 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 37 | |
| 38 | In SO BPMN in mechanism making re-subscription to /events/unauthenticated.PNF_READY topic there is an issue `SO-1253 <https://jira.onap.org/projects/SO/issues/SO-1253>`_. |
| 39 | By default after ONAP and PRH deploy DMaaP topic /events/unauthenticated.PNF_READY is not present. |
| 40 | It is created by PRH after first expected PNF registration event arrival to ONAP system. |
| 41 | If service for PNF will be created before topic /events/unauthenticated.PNF_READY will be present then service will not be able to read from the topic. |
| 42 | |
| 43 | |
| 44 | **Workaround** |
| 45 | |
| 46 | - Before starting any PNF service verify if unauthenticated.PNF_READY topic exists using command: |
| 47 | |
| 48 | :: |
| 49 | |
| 50 | curl --header "Content-type: application/json" --request GET http://<kubernetes slave IP>:30227/topics/listAll |
| 51 | |
| 52 | - If it doesn't exists send following curl in order to create topic: |
| 53 | |
| 54 | :: |
| 55 | |
| 56 | curl --header "Content-type: application/json" --request POST --data '[{"correlationId": "test"}]' http://<kubernetes slave IP>:30227/events/unauthenticated.PNF_READY |
| 57 | |
| 58 | - Once again verify if topic exists |
| 59 | - If the PNF service will be started before unauthenticated.PNF_READY topic creation, then there will be a need to restart SO-BPMN docker container |
| 60 | |
| 61 | |