aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHector Anapan <ha076r@att.com>2017-10-09 16:43:56 -0400
committerPatrick Brady <pb071s@att.com>2017-10-10 08:31:42 -0700
commit6363507451115bf4f8f2e639f4eca02a3afd2260 (patch)
treeaf482c3b4c6d590d403c2f8e2049da2ba94d5588
parent2f9234d4ba687c6b7aff093bc104a6c8eea31e24 (diff)
Add APPC Properties documentation to readthedocs
Adding documentation regarding APPC properties, which ones are available to be modified in appc.properties, and how they are used to implement/use APPC features. Change-Id: I95719a628df1a11a68aaff8711f67cc2dbcb053f Signed-off-by: Hector Anapan <ha076r@att.com> Issue-Id: [APPC-247]
-rw-r--r--docs/APPC Properties/APPC Properties.rst91
-rw-r--r--docs/index.rst1
2 files changed, 92 insertions, 0 deletions
diff --git a/docs/APPC Properties/APPC Properties.rst b/docs/APPC Properties/APPC Properties.rst
new file mode 100644
index 0000000..67c1460
--- /dev/null
+++ b/docs/APPC Properties/APPC Properties.rst
@@ -0,0 +1,91 @@
+===========================
+APPC - Available Properties
+===========================
+
+Introduction
+============
+
+The current list of properties that can be overwritten from all
+default.properties files to `appc.properties
+<https://gerrit.onap.org/r/gitweb?p=appc/deployment.git;a=blob;f=installation/src/main/properties/appc.properties;h=b2d4e1c0dfe44a6c5d7cab4b9d2a0463b2889bfd;hb=HEAD>`_ are listed below. Please note
+that some properties have default values since some code requires it to
+be defined as part of the building/compilation process.
+
+- The only defined property values in appc.properties are the
+ following:
+
+ - "appc.ClosedLoop1607.\*" properties (needed for demo)
+ - "appc.provider.vfodl.url" property (needed for demo)
+ - "appc.service.logic.module.name" property (needed for demo)
+ - "appc.topology.dg.\*" properties (needed for demo)
+
+Properties List
+===============
+
+The following properties are ready to be defined based on which feature
+needs to be tested or used:
+
+- **provider1.\* properties**:
+
+ - Applies to the following features: appc-rest-adapter-bundle,
+ appc-chef-adapter-bundle, appc-iaas-adapter-bundle
+ - These properties need to be defined in order to use
+ OpenStack-based API executions. For example, the APPC function
+ "restart" is in charge of restarting a VM when requested.
+ Therefore, properties such as OpenStack credentials, tenant name,
+ VM ID, and others pre-defined in the appc.properties need to be
+ defined with the information of the OpenStack Environment you are
+ deploying APPC from.
+
+- **dmaap.poolMembers property**:
+
+ - Applies to the following features: appc-command-executor-core,
+ appc-license-manager-core, appc-lifecycle-management-core,
+ appc-request-handler-core, and appc-workflow-management-core (all
+ part of the appc-dispatcher package)
+ - Defines the DMaaP IP or URL location of the DMaaP Pool Members
+ involved in the DMaaP Communication of that feature in specific
+ (NOTE: More than one Pool Member can be defined in the form of a
+ comma-delimited list)
+
+- **appc.ClosedLoop.\* properties**:
+
+ - Applies to the following feature: appc-event-listener-bundle (both
+ in src/main and src/test)
+ - These properties define in which DMaaP will the
+ appc-event-listener feature will listen in
+
+- **appc.LCM.\* properties**:
+
+ - Applies to the following feature: appc-event-listener-bundle (in
+ src/test only)
+ - These properties define in which DMaaP will the
+ appc-event-listener feature will listen in. These properties are
+ especifically used to define LCM (LifeCycle Management) actions,
+ and are only used as part of JUnit Test Cases.
+
+- **test.\* properties**:
+
+ - Applies to the following features: appc-rest-adapter-bundle,
+ appc-chef-adapter-bundle, appc-iaas-adapter-bundle
+ - These are properties that test OpenStack-based APPC API requests
+
+- **appc.asdc.\* properties**:
+
+ - Applies to the following feature: appc-asdc-listener-bundle
+ - These properties are used to test integration between the SDC
+ ONAP component & APPC. Properties such as pointing to the
+ DMaaP listener & topic, SDC credentials to authenticate into the
+ SDC component, define the RESTCONF URL, and others are mapped
+ here.
+
+- **Other properties**:
+
+ - poolMembers, event.pool.members, restconf.user, restconf.pass
+
+ - Applies to the following features: appc-netconf-adapter-bundle,
+ appc-dg-common, appc-dmaap-adapter-bundle
+ - These properties can be defined to use the features defined
+ above. They are used to point to current DMaaP listener, and to
+ define the RESTCONF credentials needed to execute APPC API
+ requests from the features impacted above.
diff --git a/docs/index.rst b/docs/index.rst
index 6d3c9aa..e3c87e2 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -10,3 +10,4 @@ APPC Deployment Documentation Repository
Chef Adapter/Chef Adapter
Ansible Adapter/Ansible Adapter
Platform Logic/Platform Logic
+ APPC Properties/APPC Properties