From ac853c1e7186b10e34e392918af31e4ac62b45c2 Mon Sep 17 00:00:00 2001 From: Michael Hwang Date: Tue, 14 Feb 2017 15:10:16 +0000 Subject: Make first commit Transferring from original dcae project Issue-Id: DCAEGEN2-45 Change-Id: If8500f4a120ec2d27a714c8917f163beb57ee64c Signed-off-by: Michael Hwang --- docs/Deployment.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 docs/Deployment.md (limited to 'docs/Deployment.md') diff --git a/docs/Deployment.md b/docs/Deployment.md new file mode 100644 index 0000000..ff3974f --- /dev/null +++ b/docs/Deployment.md @@ -0,0 +1,39 @@ +# Deployment Guide - DCAE Inventory +*Last update: 2016-11-04* + +## Requirements + +### Network + +Requires ports 8080 to be open for inbound traffic on the machine that the service is hosted on. + +The DCAE Inventory relies on connectivity to a Postgres database, a DCAE Controller service instance, and a Databus Controller service instance all of which are configurable through the configuration file. The DCAE Inventory makes client-side calls to these external services. + +DCAE Inventory supports both HTTP and HTTPS through configuration setup. + +### Configuration + +The DCAE Inventory requires a configuration file and requires three groups of environment-dependent dynamic configuration information: + +1. Postgres database connection details + - `user` + - `password` + - `url` +2. DCAE controller connection details + - `host` + - `port` + - `basePath` + - `user` + - `password` +3. DMaaP controller connection details + - `host` + +In order for HTTPS to be enabled for DCAE Inventory, an HTTPS `applicationConnectors` need to be added to the configuration file. Details of this can be found [here](http://www.dropwizard.io/0.7.1/docs/manual/configuration.html#https). What is required at deployment time is a valide key store file (e.g. `PKCS12`) (i.e. set via `keyStorePath` parameter in the config) with the accompanying password (i.e. set via `keyStorePassword` parameter in the config). + +## Run Command + +The DCAE Inventory has been developed and tested using Java 8. Here is a sample run command: + +``` +java -jar dcae-inventory-2.3.1.jar server /opt/config.yml +``` -- cgit 1.2.3-korg