blob: b39b007d65ae6181c0eb15f57fc8041dbc0bad9e [file] [log] [blame]
Vijay VK86cd8932018-10-23 16:35:29 +01001.. This work is licensed under a Creative Commons Attribution 4.0 International License.
2.. http://creativecommons.org/licenses/by/4.0
3
4Installation
5============
6
Vijay VKedaf8b12019-05-23 22:02:50 +01007VESCollector is installed via cloudify blueprint by DCAE bootstrap process on typical ONAP installation.
8As the service is containerized, it can be started on stand-alone mode also.
9
10
Vijay VK86cd8932018-10-23 16:35:29 +010011To run VES Collector container on standalone mode, following parameters are required
12
VENKATESH KUMARfac34a12019-01-20 20:15:08 -050013 ``docker run -d -p 8080:8080/tcp -p 8443:8443/tcp -P -e DMAAPHOST='10.0.11.1' nexus.onap.org:10001/onap/org.onap.dcaegen2.collectors.ves.vescollector:1.3.2``
Vijay VK86cd8932018-10-23 16:35:29 +010014
15
16DMAAPHOST is required for standalone; for normal platform installed instance the publish URL are obtained from Consul. Below parameters are exposed for DCAE platform (cloudify) deployed instance
17
18
19- COLLECTOR_IP
20- DMAAPHOST - should contain an address to DMaaP, so that event publishing can work
21- CBSPOLLTIMER - it should be put in here if we want to automatically fetch configuration from CBS.
22- CONSUL_PROTOCOL - Consul protocol by default set to **http**, if it is need to change it then that can be set to different value
23- CONSUL_HOST - used with conjunction with CBSPOLLTIMER, should be a host address (without port! e.g my-ip-or-host) where Consul service lies
24- CBS_PROTOCOL - Config Binding Service protocol by default set to **http**, if it is need to change it then that can be set to different value
25- CONFIG_BINDING_SERVICE - used with conjunction with CBSPOLLTIMER, should be a name of CBS as it is registered in Consul
26- HOSTNAME - used with conjunction with CBSPOLLTIMER, should be a name of VESCollector application as it is registered in CBS catalog
27
28These parameters can be configured either by passing command line option during `docker run` call or by specifying environment variables named after command line option name