From 9f91de5d3e1c6d9b535db6a958e3598221b75d58 Mon Sep 17 00:00:00 2001 From: Radoslaw Jablonski Date: Wed, 17 Oct 2018 15:05:51 +0100 Subject: docker.userguide: Add a note about bar-collectd run without DPDK/RDT Added a note with information what happens if RDT/DPDK dependency will be missing on host during manual starting bar-collectd container(with info what should be done in such scenario to start bar-collectd anyway) Change-Id: I11ba595e8925027c772920876c4bf2967f33de88 Signed-off-by: Radoslaw Jablonski --- docs/release/userguide/docker.userguide.rst | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/release/userguide/docker.userguide.rst b/docs/release/userguide/docker.userguide.rst index ec856555..15acf386 100644 --- a/docs/release/userguide/docker.userguide.rst +++ b/docs/release/userguide/docker.userguide.rst @@ -614,11 +614,28 @@ Run the collectd docker image plugins. In the command above we are overriding /opt/collectd/etc/collectd.conf.d by mounting a host directory src/collectd/collectd_sample_configs that contains only the sample - configurations we are interested in running. *It's important to do - this if you don't have DPDK, or RDT installed on the host*. + configurations we are interested in running. + + *If some dependencies for plugins listed in configuration directory + aren't met, then collectd startup may fail(collectd tries to + initialize plugins configurations for all given config files that can + be found in shared configs directory and may fail if some dependency + is missing).* + + If `DPDK` or `RDT` can't be installed on host, then corresponding config + files should be removed from shared configuration directory + (`/src/collectd/collectd_sample_configs/`) prior + to starting barometer-collectd container. By example: in case of missing + `DPDK` functionality on the host, `dpdkstat.conf` and `dpdkevents.conf` + should be removed. + Sample configurations can be found at: https://github.com/opnfv/barometer/tree/master/src/collectd/collectd_sample_configs + List of barometer-collectd dependencies on host for various plugins + can be found at: + https://wiki.opnfv.org/display/fastpath/Barometer-collectd+host+dependencies + Check your docker image is running .. code:: bash -- cgit 1.2.3-korg