Update PM Mapper documentation 50/92250/2
authordfarrelly <david.farrelly@est.tech>
Thu, 1 Aug 2019 09:57:08 +0000 (09:57 +0000)
committerdfarrelly <david.farrelly@est.tech>
Thu, 1 Aug 2019 09:57:08 +0000 (09:57 +0000)
Issue-ID: DCAEGEN2-1038
Change-Id: I9a8ca2c250553d955a81779e7119a9794ee4ff4c
Signed-off-by: dfarrelly <david.farrelly@est.tech>
docs/sections/services/pm-mapper/configuration.rst
docs/sections/services/pm-mapper/delivery.rst
docs/sections/services/pm-mapper/installation.rst
docs/sections/services/pm-mapper/logging.rst

index d7a13aa..1e676c6 100644 (file)
@@ -43,7 +43,7 @@ PM Mapper publishes the perf3gpp VES PM Events to the following authenticated MR
 
 ::
 
-        org.onap.dmaap.mr.PM_MAPPER
+        org.onap.dmaap.mr.PERFORMANCE_MEASUREMENTS
 
 Performance
 ^^^^^^^^^^^
index 30a886c..207d4c9 100644 (file)
@@ -11,4 +11,4 @@ Docker Container
 
 ::
 
-    ``docker run -d --name pmmapper -e CONFIG_BINDING_SERVICE_SERVICE_HOST=<IP Required> -e CONFIG_BINDING_SERVICE_SERVICE_PORT=<Port Required> -e HOSTNAME=<HOSTNAME>  nexus3.onap.org:10001/onap/org.onap.dcaegen2.services.pm-mapper:1.0.1``
+    ``docker run -d --name pmmapper -e CONFIG_BINDING_SERVICE_SERVICE_HOST=<IP Required> -e CONFIG_BINDING_SERVICE_SERVICE_PORT=<Port Required> -e HOSTNAME=<HOSTNAME>  nexus3.onap.org:10001/onap/org.onap.dcaegen2.services.pm-mapper``
index 51ae5a4..ad96e5d 100644 (file)
@@ -21,7 +21,7 @@ Enter the Cloudify Manager kuberenetes pod
 \r
     - Download the PM Mapper blueprint onto the pod, this can be found in:\r
 \r
-        https://gerrit.onap.org/r/gitweb?p=dcaegen2/services/pm-mapper.git;a=blob_plain;f=dpo/blueprints/k8s-pm-mapper.yaml;h=b331e41222377b8fbf7b68b4f5fff5ba5998da16;hb=refs/heads/dublin\r
+        https://git.onap.org/dcaegen2/services/pm-mapper/tree/dpo/blueprints/k8s-pm-mapper.yaml\r
 \r
     - Create inputs.yaml\r
 \r
@@ -36,8 +36,8 @@ Enter the Cloudify Manager kuberenetes pod
             :delim: ;\r
             :header: Property , Sample Value , Description , Required\r
 \r
-            aaf_username ; dcae@dcae.onap.org ; In the Dublin release information about the AAF user must be provided to enable publishing to authenticated topics. ; Yes\r
-            aaf_password ; <dcae_password> ; This is the password for the given user e.g.  The <dcae_password> is dcae@dcae.onap.org's password. ; Yes\r
+            client_id ; dcae@dcae.onap.org ; In the Dublin release information about the AAF user must be provided to enable publishing to authenticated topics. ; Yes\r
+            client_password ; <dcae_password> ; This is the password for the given user e.g.  The <dcae_password> is dcae@dcae.onap.org's password. ; Yes\r
             enable_http ; true ; By default, the PM-Mapper will only allow inbound queries over HTTPS. However, it is possible to configure it to enable HTTP also. ; No\r
             tag_version ; nexus3.onap.org:10001/onap/org.onap.dcaegen2.services.pm-mapper:1.0.1 ; The tag of the Docker image will be used when deploying the PM-Mapper. ; No\r
             pm-mapper-filter ; {"filters": [{"pmDefVsn":"targetVersion", "nfType":"targetNodeType", "vendor":"targetVendor","measTypes":["targetMeasType"]}]} ; The default behavior of the PM-Mapper is to map all measType in the received PM XML files, however, it's possible to provide filtering configuration which will reduce the VES event to the counters that the designer has expressed interest in. ; No\r
@@ -46,10 +46,10 @@ Enter the Cloudify Manager kuberenetes pod
 \r
         .. code-block:: yaml\r
 \r
-                aaf_username: dcae@dcae.onap.org\r
-                aaf_password: <dcae_password>\r
+                client_id: dcae@dcae.onap.org\r
+                client_password: <dcae_password>\r
                 enable_http: false\r
-                tag_version: nexus3.onap.org:10001/onap/org.onap.dcaegen2.services.pm-mapper:1.0.1\r
+                tag_version: nexus3.onap.org:10001/onap/org.onap.dcaegen2.services.pm-mapper:latest\r
                 pm-mapper-filter: {"filters": []}\r
 \r
 \r
@@ -59,4 +59,3 @@ Enter the Cloudify Manager kuberenetes pod
         .. code-block:: bash\r
 \r
             cfy install --blueprint-id pm-mapper --deployment-id pm-mapper -i inputs.yaml k8s-pm-mapper.yaml\r
-\r
index cc56f41..b5769f8 100644 (file)
@@ -4,4 +4,13 @@
 Logging\r
 =======\r
 \r
-The log file is located under /var/log/ONAP/dcaegen2/services/pm-mapper/pm-mapper_output.log.\r
+There are two separate log files in the PM Mapper container.\r
+\r
+The main log file is located under /var/log/ONAP/dcaegen2/services/pm-mapper/pm-mapper_output.log.\r
+\r
+The human readable log file which contains less information is located under /var/log/ONAP/dcaegen2/services/pm-mapper/pm-mapper_output_readable.log.\r
+\r
+Log Level\r
+"""""""""\r
+\r
+The PM Mapper log level is set to INFO by default. This can be changed in the running container by editing the logLevel variable in the logback.xml file located under /opt/app/pm-mapper/etc/logback.xml. Changes to this file will be picked up every 30 seconds.\r