diff options
author | Krzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com> | 2021-04-16 12:47:19 +0200 |
---|---|---|
committer | Krzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com> | 2021-04-16 12:47:19 +0200 |
commit | 09f56278f78bd8bc14b25727d865e8526e5a7f9d (patch) | |
tree | 6cb13a51fe1ef2ef16e741e4b5ad7cc80ae235d3 | |
parent | f94dd5baf059e1f068ed66417dbad603bfac944f (diff) |
[INTEGRATION] Add NF simulator documentation in read the docs
fix indents and bullet points
Issue-ID: INT-1869
Signed-off-by: Krzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com>
Change-Id: I1fae12aa024baf852bd9dc36b06a26a341d9dea2
-rw-r--r-- | docs/simulators/nf_simulator.rst | 137 |
1 files changed, 68 insertions, 69 deletions
diff --git a/docs/simulators/nf_simulator.rst b/docs/simulators/nf_simulator.rst index 9ba295a55..8b7fae89a 100644 --- a/docs/simulators/nf_simulator.rst +++ b/docs/simulators/nf_simulator.rst @@ -18,25 +18,25 @@ The simulator is expected to cover planned NF behaviour - receive the config cha **Figure 1. Architecture Overview** -NF Simulator code is stored in https://github.com/onap/integration-simulators-nf-simulator and all it's sub repos are: +1. NF Simulator code is stored in https://github.com/onap/integration-simulators-nf-simulator and all it's sub repos are: -- for VES Client - https://github.com/onap/integration-simulators-nf-simulator-ves-client -- for Netconf Server - https://github.com/onap/integration-simulators-nf-simulator-netconf-server -- for AVCN Manager - https://github.com/onap/integration-simulators-nf-simulator-avcn-manager -- for PM HTTPS Server - https://github.com/onap/integration-simulators-nf-simulator-pm-https-server + - for VES Client - https://github.com/onap/integration-simulators-nf-simulator-ves-client + - for Netconf Server - https://github.com/onap/integration-simulators-nf-simulator-netconf-server + - for AVCN Manager - https://github.com/onap/integration-simulators-nf-simulator-avcn-manager + - for PM HTTPS Server - https://github.com/onap/integration-simulators-nf-simulator-pm-https-server -For above components have been prepared: +2. For above components have been prepared: -- docker images in ONAP Nexus: + - docker images in ONAP Nexus: - - VES Client image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.vesclient - - AVCN Manager image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.avcnmanager - - PM HTTPS Server image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.pmhttpsserver - - Netconf Server images - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.netconfserver + - VES Client image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.vesclient + - AVCN Manager image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.avcnmanager + - PM HTTPS Server image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.pmhttpsserver + - Netconf Server images - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.netconfserver -- example helm charts: + - example helm charts: - - `Helm charts <https://github.com/onap/integration-simulators-nf-simulator/tree/master/helm>`_ + - `Helm charts <https://github.com/onap/integration-simulators-nf-simulator/tree/master/helm>`_ **VES Client, Netconf Server and PM HTTPS Server can be used and deployed separately depending on needs.** @@ -45,67 +45,66 @@ Only AVCN Manger connects VES Client with Netconf Server in order to support O1 1. VES Client: -------------- - Application that generates VES events on demand. +Application that generates VES events on demand. - **What does it do?** - - - Supports both basic auth and TLS CMPv2 method of authentication. - - Allows to turn on and turn off hostname, verification in SSL. - - Allows to send one-time event and periodic events, based on event templates. - - Exposes API to manage VES Client - - Provides template mechanism (Template is a draft event. Merging event with patch will result in valid VES event. - Template itself should be a correct VES event as well as valid json object. ) - - Patching - User is able to provide patch in request, which will be merged into template. - - Simulator supports corresponding keywords in templates: RandomInteger(start,end), RandomPrimitiveInteger(start,end), RandomInteger, - RandomString(length), RandomString, Timestamp, TimestampPrimitive, Increment - - In place variables support - Simulator supports dynamic keywords e.g. #dN to automatically substitute selected phrases in defined json schema. - - Logging - Every start of simulator will generate new logs that can be found in docker ves-client container. - - Swagger - Detailed view of simulator REST API is available via Swagger UI - - History - User is able to view events history. +**What does it do?** +- Supports both basic auth and TLS CMPv2 method of authentication. +- Allows to turn on and turn off hostname, verification in SSL. +- Allows to send one-time event and periodic events, based on event templates. +- Exposes API to manage VES Client +- Provides template mechanism (Template is a draft event. Merging event with patch will result in valid VES event. + Template itself should be a correct VES event as well as valid json object. ) +- Patching - User is able to provide patch in request, which will be merged into template. +- Simulator supports corresponding keywords in templates: RandomInteger(start,end), RandomPrimitiveInteger(start,end), RandomInteger, + RandomString(length), RandomString, Timestamp, TimestampPrimitive, Increment +- In place variables support - Simulator supports dynamic keywords e.g. #dN to automatically substitute selected phrases in defined json schema. +- Logging - Every start of simulator will generate new logs that can be found in docker ves-client container. +- Swagger - Detailed view of simulator REST API is available via Swagger UI +- History - User is able to view events history. 2. Netconf Server: ------------------ - This server uses sysrepo to simulate network configuration. - It is based on sysrepo-netopeer2 image. +This server uses sysrepo to simulate network configuration. +It is based on sysrepo-netopeer2 image. - **What does it do?** +**What does it do?** - Server allows to: +Server allows to: - - install custom configuration models on start up. - - change configuration of that modules on runtime. - - use TLS custom certificates - - configure change subscription for particular YANG modules (Netconf server image run python application on the startup.) - - manage netconf server using REST interface, with endpoints: +- install custom configuration models on start up. +- change configuration of that modules on runtime. +- use TLS custom certificates +- configure change subscription for particular YANG modules (Netconf server image run python application on the startup.) +- manage netconf server using REST interface, with endpoints: - - GET /healthcheck returns 200 "UP" if server is up and running - - POST /readiness return 200 "Ready" if server is ready, if not, returns 503 "Not Ready" - - POST /change_config/<path:module_name> changes configuration ad returns 202 "Accepted" - - GET /change_history returns 200 and change history as json - - GET /get_config/<path:module_name> returns 200 and current configuration + - GET /healthcheck returns 200 "UP" if server is up and running + - POST /readiness return 200 "Ready" if server is ready, if not, returns 503 "Not Ready" + - POST /change_config/<path:module_name> changes configuration ad returns 202 "Accepted" + - GET /change_history returns 200 and change history as json + - GET /get_config/<path:module_name> returns 200 and current configuration 3. AVCN Manager: ---------------- - Manager that fetches changes of configuration from kafka and sends them to VES client. +Manager that fetches changes of configuration from kafka and sends them to VES client. - **What does it do?** +**What does it do?** - The manager processes notifications from NETCONF server. It does this by being a subscriber of a Kafka topic that is fed - with NETCONF notifications. Incoming notifications are then processed and output of this processing is sent to VES client. +The manager processes notifications from NETCONF server. It does this by being a subscriber of a Kafka topic that is fed +with NETCONF notifications. Incoming notifications are then processed and output of this processing is sent to VES client. 4. PM HTTPS Server: ------------------- - Server that is used in Bulk PM usecases over HTTPS +Server that is used in Bulk PM usecases over HTTPS - **What does it do?** +**What does it do?** - - Supports TLS (CMPv2) method of authentication (used during connection to Data File Collector) - - Allows to use custom certificates - - Exposes REST API in order to manage PM files stored in HTTPS server +- Supports TLS (CMPv2) method of authentication (used during connection to Data File Collector) +- Allows to use custom certificates +- Exposes REST API in order to manage PM files stored in HTTPS server Guides @@ -113,30 +112,30 @@ Guides User And Developer Guide ------------------------ -User guides: +1. User guides: -- `VES Client user guide. <https://github.com/onap/integration-simulators-nf-simulator-ves-client/blob/master/README.md>`_ -- `AVCN Manager user guide. <https://github.com/onap/integration-simulators-nf-simulator-avcn-manager/blob/master/README.md>`_ -- `PM HTTPS Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-pm-https-server/blob/master/README.md>`_ -- `Netconf Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/README.md>`_ -- `Netconf Notification Application user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/src/python/README.md>`_ -- `NF Simulator CLI user guide <https://github.com/onap/integration-simulators-nf-simulator/blob/master/simulator-cli/README.md>`_ + - `VES Client user guide. <https://github.com/onap/integration-simulators-nf-simulator-ves-client/blob/master/README.md>`_ + - `AVCN Manager user guide. <https://github.com/onap/integration-simulators-nf-simulator-avcn-manager/blob/master/README.md>`_ + - `PM HTTPS Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-pm-https-server/blob/master/README.md>`_ + - `Netconf Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/README.md>`_ + - `Netconf Notification Application user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/src/python/README.md>`_ + - `NF Simulator CLI user guide <https://github.com/onap/integration-simulators-nf-simulator/blob/master/simulator-cli/README.md>`_ -Jenkins builds: +2. Jenkins builds: -- `VES Client jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-avcn-manager/>`_ -- `AVCN Manager jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/>`_ -- `PM HTTPS Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-pm-https-server/>`_ -- `Netconf Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-ves-client/>`_ + - `VES Client jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-avcn-manager/>`_ + - `AVCN Manager jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/>`_ + - `PM HTTPS Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-pm-https-server/>`_ + - `Netconf Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-ves-client/>`_ -NF Simulator CSIT test cases: +3. NF Simulator CSIT test cases: -- `Project integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites/>`_ -- `Project integration-simulators-nf-simulator-netconf-server-master-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-csit-testsuites/>`_ + - `Project integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites/>`_ + - `Project integration-simulators-nf-simulator-netconf-server-master-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-csit-testsuites/>`_ -NF Simulator sanity checks: +4. NF Simulator sanity checks: -- https://github.com/onap/integration-simulators-nf-simulator/tree/master/sanitycheck + - https://github.com/onap/integration-simulators-nf-simulator/tree/master/sanitycheck .. |image1| image:: ../files/simulators/NF-Simulator.png :width: 10in
\ No newline at end of file |