From 8638cfbf3047626986b6037f98b610f25884f5d8 Mon Sep 17 00:00:00 2001 From: Joanna Jeremicz Date: Thu, 10 Feb 2022 13:23:35 +0100 Subject: [PM-MAPPER] Add helm installation information in pm-mapper documentation Issue-ID: DCAEGEN2-2964 Signed-off-by: Joanna Jeremicz Change-Id: I335ff40acd3f24cb3759b1839e5a2116f31b9d6c --- docs/sections/services/pm-mapper/index.rst | 1 + .../services/pm-mapper/installation-helm.rst | 97 ++++++++++++++++++++++ docs/sections/services/pm-mapper/installation.rst | 4 +- 3 files changed, 100 insertions(+), 2 deletions(-) create mode 100644 docs/sections/services/pm-mapper/installation-helm.rst 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 `_ repository. + + Example command: + +.. code-block:: bash + + helm -n onap install dev-dcaegen2-services-pm-mapper -f --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. -- cgit 1.2.3-korg