update link to upper-constraints.txt

[dcaegen2.git] / docs / sections / services / pm-mapper / configuration.rst

diff --git a/docs/sections/services/pm-mapper/configuration.rst b/docs/sections/services/pm-mapper/configuration.rst
index df7423a..fbac01c 100644 (file)
--- a/docs/sections/services/pm-mapper/configuration.rst
+++ b/docs/sections/services/pm-mapper/configuration.rst
@@ -1,5 +1,8 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
 .. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2022 Nokia. All rights reserved.
+.. Copyright (c) 2023 AT&T Intellectual Property. All rights reserved.
+
 
 Configuration and Performance
 =============================
@@ -15,31 +18,54 @@ In order to parallel processing, new configuration env has been introduced:
 
 - PROCESSING_THREADS_COUNT (optional, default value: number of threads available to JVM) - allows to specify number of threads that will be used for files processing.
 
+.. _pm_mapper_disable_tls:
 
-Envs should be specified in section "envs:" in blueprint. Example part of blueprint configuration:
+Disable TLS
+"""""""""""
+Pm-mapper by default uses communication over TLS, but it is also possible to use plain http request. To disable TLS, set configuration flag 'enable_http' to true, and set the certificate paths to empty strings or remove them from the configuration. See the config.yaml examples below.
 
-::
+.. code-block:: yaml
+
+  applicationConfig:
+    enable_http: true
+    key_store_path: ""
+    key_store_pass_path: ""
+    trust_store_path: ""
+    trust_store_pass_path: ""
+
+
+
+Or
+
+.. code-block:: yaml
+
+  applicationConfig:
+    enable_http: true
+    #key_store_path:
+    #key_store_pass_path:
+    #trust_store_path:
+    #trust_store_pass_path:
+
+
+Unauthenticated topic
+"""""""""""""""""""""
+To use unauthenticated topics :ref:`disable TLS <pm_mapper_disable_tls>`, and edit AAF credentials in configuration, it should be removed or set to empty string. See the examples below.
+
+.. code-block:: yaml
+
+  applicationConfig:
+    aaf_identity: ""
+    aaf_password: ""
+
+
+Or
+
+.. code-block:: yaml
+
+  applicationConfig:
+    #aaf_identity:
+    #aaf_password:
 
-        ...
-        pm-mapper:
-          type: dcae.nodes.ContainerizedServiceComponentUsingDmaap
-          interfaces:
-            cloudify.interfaces.lifecycle:
-              create:
-                inputs:
-                  ports:
-                    - '8443:0'
-                    - '8081:0'
-                  envs:
-                    PROCESSING_LIMIT_RATE: "1"
-                    THREADS_MULTIPLIER: "2"
-                    PROCESSING_THREADS_COUNT: "3"
-          relationships:
-            - type: dcaegen2.relationships.subscribe_to_files
-              target: pm-feed
-            - type: dcaegen2.relationships.publish_events
-              target: pm-topic
-        ...
 
 
 PM Mapper Filtering