diff options
authorRadoslaw Jablonski <radoslawx.jablonski@intel.com>2018-11-27 08:57:24 +0000
committerRadoslaw Jablonski <radoslawx.jablonski@intel.com>2018-11-27 14:22:37 +0000
commite59cf7e82c810eaf74a651ec9e52393b736fc19f (patch)
parente955b0d0ac1d500f6c5ed952c7ad42dac7c4a8f8 (diff)
docker.userguide: Add info about using influxdb in multi-node setup
Added chapter about steps that have to be performed in order to run collect and influxdb on separate Hosts (manual setup) Change-Id: Ia4b1234aa1346afdc27ec5eabb795dfac06f0522 Signed-off-by: Radoslaw Jablonski <radoslawx.jablonski@intel.com>
1 files changed, 52 insertions, 0 deletions
diff --git a/docs/release/userguide/docker.userguide.rst b/docs/release/userguide/docker.userguide.rst
index c184abf..9b928cb 100644
--- a/docs/release/userguide/docker.userguide.rst
+++ b/docs/release/userguide/docker.userguide.rst
@@ -772,6 +772,58 @@ To make some changes when the container is running run:
sudo docker exec -ti <CONTAINER ID> /bin/bash
+When both collectd and InfluxDB containers are located
+on the same host, then no additional configuration have to be added and you
+can proceed directly to `Run the Grafana docker image`_ section.
+Modify collectd to support InfluxDB on another host
+If InfluxDB and collectd containers are located on separate hosts, then
+additional configuration have to be done in ``collectd`` container - it
+normally sends data using network plugin to 'localhost/' therefore
+changing output location is required:
+1. Stop and remove running bar-collectd container (if it is running)
+ .. code:: bash
+ $ sudo docker ps #to get collectd container name
+ $ sudo docker rm -f <COLLECTD_CONTAINER_NAME>
+2. Go to location where shared collectd config files are stored
+ .. code:: bash
+ $ cd src/collectd/collectd_sample_configs
+3. Edit content of ``network.conf`` file.
+ By default this file looks like that:
+ .. code::
+ LoadPlugin network
+ <Plugin network>
+ Server "" "25826"
+ </Plugin>
+ ```` string has to be replaced with the IP address of host where
+ InfluxDB container is running (e.g. ````). Edit this using your
+ favorite text editor.
+4. Start again collectd container like it is described in
+ `Run the collectd docker image`_ chapter
+ .. code:: bash
+ $ sudo docker run -ti --name bar-collectd --net=host -v \
+ `pwd`/src/collectd/collectd_sample_configs:/opt/collectd/etc/collectd.conf.d \
+ -v /var/run:/var/run -v /tmp:/tmp --privileged opnfv/barometer-collectd
+Now collectd container will be sending data to InfluxDB container located on
+remote Host pointed by IP configured in step 3.
Run the Grafana docker image