summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJoanna Jeremicz <joanna.jeremicz@nokia.com>2022-02-10 13:23:35 +0100
committerJoanna Jeremicz <joanna.jeremicz@nokia.com>2022-02-11 11:33:21 +0100
commit8638cfbf3047626986b6037f98b610f25884f5d8 (patch)
treee21746e95f587afdb195586f4c8101f8d81fba34 /docs
parentd13cdebe6ce465b0245d8d484892e1828e974261 (diff)
[PM-MAPPER] Add helm installation information in pm-mapper documentation
Issue-ID: DCAEGEN2-2964 Signed-off-by: Joanna Jeremicz <joanna.jeremicz@nokia.com> Change-Id: I335ff40acd3f24cb3759b1839e5a2116f31b9d6c
Diffstat (limited to 'docs')
-rw-r--r--docs/sections/services/pm-mapper/index.rst1
-rw-r--r--docs/sections/services/pm-mapper/installation-helm.rst97
-rw-r--r--docs/sections/services/pm-mapper/installation.rst4
3 files changed, 100 insertions, 2 deletions
diff --git a/docs/sections/services/pm-mapper/index.rst b/docs/sections/services/pm-mapper/index.rst
index 8a53753d..d8834b18 100644
--- a/docs/sections/services/pm-mapper/index.rst
+++ b/docs/sections/services/pm-mapper/index.rst
@@ -14,5 +14,6 @@
./delivery.rst
./logging.rst
./installation.rst
+ ./installation-helm.rst
./configuration.rst
./troubleshooting.rst
diff --git a/docs/sections/services/pm-mapper/installation-helm.rst b/docs/sections/services/pm-mapper/installation-helm.rst
new file mode 100644
index 00000000..04e7503d
--- /dev/null
+++ b/docs/sections/services/pm-mapper/installation-helm.rst
@@ -0,0 +1,97 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. _pm-mapper-installation-helm:
+
+PM-Mapper Helm Installation
+===========================
+
+PM mapper is a microservice that can be installed via Helm.
+The chart files are hosted in `OOM <https://gerrit.onap.org/r/gitweb?p=oom.git;a=tree;f=kubernetes/dcaegen2-services/components/dcae-pm-mapper>`_ repository.
+
+ Example command:
+
+.. code-block:: bash
+
+ helm -n onap install dev-dcaegen2-services-pm-mapper -f <custom values filename> --set global.centralizedLoggingEnabled=false dcaegen2-services/components/dcae-pm-mapper/
+
+
+Dependencies
+^^^^^^^^^^^^
+
+List of services which should be running prior PM-Mapper installation:
+
+ - DMaaP Message Router
+ - DMaaP Data Router
+ - DMaaP Bus Controller post install jobs should have completed successfully (executed as part of an OOM install).
+ - Data File Collector
+
+Configuration
+^^^^^^^^^^^^^
+
+PM-Mapper uses SDK's Config Binding Service client for initial and periodical configuration application.
+Consul is not needed anymore. It is used as a second choice source of configuration (if the default one is unavailable).
+By default, a ConfigMap is used to load, and later change the configuration in runtime.
+
+The location of the configuration file should be set in ``CBS_CLIENT_CONFIG_PATH`` env, for example:
+
+ ``CBS_CLIENT_CONFIG_PATH: /app-config-input/application_config.yaml``
+
+Example yaml file with PM-Mapper configuration:
+
+.. code-block:: yaml
+
+ pm-mapper-filter:
+ filters:
+ - pmDefVsn: "1.0"
+ nfType: "gnb"
+ vendor: "Nokia"
+ measTypes:
+ - attTCHSeizures
+ - succTCHSeizures2
+ - succImmediateAssignProcs8
+ key_store_path: "/opt/app/pm-mapper/etc/certs/cert.jks"
+ key_store_pass_path: "/opt/app/pm-mapper/etc/certs/jks.pass"
+ trust_store_path: "/opt/app/pm-mapper/etc/certs/trust.jks"
+ trust_store_pass_path: "/opt/app/pm-mapper/etc/certs/trust.pass"
+ dmaap_dr_delete_endpoint: "https://dmaap-dr-node:8443/delete"
+ dmaap_dr_feed_name: "1"
+ aaf_identity: "aaf_admin@people.osaaf.org"
+ aaf_password: "demo123456!"
+ enable_http: true,
+ streams_publishes:
+ dmaap_publisher:
+ type: "message_router"
+ dmaap_info:
+ topic_url: "http://message-router:3904/events/org.onap.dmaap.mr.VES_PM"
+ client_role: "org.onap.dcae.pmPublisher"
+ location: "csit-pmmapper"
+ client_id: "1562763644939"
+ streams_subscribes:
+ dmaap_subscriber:
+ type: "data_router"
+ dmaap_info:
+ username: "username"
+ password: "password"
+ location: "csit-pmmapper"
+ delivery_url: "http://dcae-pm-mapper:8081/delivery"
+ subscriber_id: 1
+
+Configuration update
+^^^^^^^^^^^^^^^^^^^^
+
+The configuration update process is very straightforward.
+The only step is to modify the Config Map which contains the configuration and save the change. PM-Mapper will detect the new configuration values after a while.
+It should be visible in PM-Mapper logs, for example:
+
+.. code-block:: text
+
+ ...
+ 2022-02-11T08:04:02.627Z main INFO org.onap.dcaegen2.services.sdk.rest.services.cbs.client.impl.CbsClientConfigMap Got successful output from ConfigMap file
+ 2022-02-11T08:04:02.627Z main INFO org.onap.dcaegen2.services.pmmapper.config.ConfigHandler Attempt to process configuration object
+ 2022-02-11T08:04:02.643Z main INFO org.onap.dcaegen2.services.pmmapper.config.ConfigHandler PM-mapper configuration processed successful
+ 2022-02-11T08:04:02.643Z main INFO org.onap.dcaegen2.services.pmmapper.config.ConfigHandler Mapper configuration:\nMapperConfig{enableHttp=true, keyStorePath='/opt/app/pm-mapper/etc/certs/cert.jks', keyStorePassPath='/opt/app/pm-mapper/etc/certs/jks.pass', trustStorePath='/opt/app/pm-mapper/etc/certs/trust.jks', trustStorePassPath='/opt/app/pm-mapper/etc/certs/trust.pass', dmaapDRDeleteEndpoint='https://dmaap-dr-node:8443/delete', filterConfig=MeasFilterConfig(filters=[]), aafUsername='aaf_admin@people.osaaf.org', aafPassword= *****, subscriberConfig=SubscriberConfig{username=username, password= *****, drLocation='csit-pmmapper', deliveryUrl='http://dcae-pm-mapper:8081/delivery', subscriberId='1'}, publisherConfig=PublisherConfig(topicUrl=http://message-router:3904/events/org.onap.dmaap.mr.VES_PM, clientRole=org.onap.dcae.pmPublisher, clientId=1562763644939, clusterLocation=csit-pmmapper)}
+ ...
+
+This logs fragment proves that the configuration source is Config Map: ``Got successful output from ConfigMap file``.
+It also prints the current configuration (the last log line above). PM-Mapper keeps checking the configuration file periodically (every 60s).
+
diff --git a/docs/sections/services/pm-mapper/installation.rst b/docs/sections/services/pm-mapper/installation.rst
index 9afc3b6b..cf7f972e 100644
--- a/docs/sections/services/pm-mapper/installation.rst
+++ b/docs/sections/services/pm-mapper/installation.rst
@@ -2,8 +2,8 @@
.. http://creativecommons.org/licenses/by/4.0
.. _pm-mapper-installation:
-Installation
-============
+Cloudify Installation
+=====================
PM mapper is a microservice that will be configured and instantiated through Cloudify Manager, either through the user
interface or the command line tool. During instantiation, the PM Mapper will fetch its configuration through the Config Binding Service. Steps to deploy using the CLI tool are shown below.