aboutsummaryrefslogtreecommitdiffstats
path: root/tools/docker/results/README.md
diff options
context:
space:
mode:
authorSridhar K. N. Rao <sridhar.rao@spirent.com>2019-06-11 12:53:58 +0530
committerSridhar K. N. Rao <sridhar.rao@spirent.com>2019-07-30 23:39:35 +0530
commitd691cc89e106d710f4d36bc3998501415588e2e1 (patch)
treefe05ef9977c2fd6a531ef3535ad11342037a48c3 /tools/docker/results/README.md
parent589639d313c24104b2a27ef16baf716d1d274108 (diff)
Docker: VSPERF Results Container.
This patch adds docker-compose.yml and related config files for creating a results container. The container hosts following services: 1. Barometer Grafana. 2. Barometer Influxdb. 2. ELK Stack. 3. OPNFV TestAPI. 4. Jupyter Notebook with VSPERF testresults-analysis. Removed dashboard files, which can be obtained from barometer-grafana. Added comment in tools.rst under pre-deployment Retained only vpserf-cases and vsperf in cases.json and projects.json Changed barometer-influxdb to influxdb:latest. Added README.md file. Added environment variable setting to disable token for jupyter JIRA: VSPERF-602 Change-Id: I37a1391a1f34f834ce0d46def75a9f3454e09772 Signed-off-by: Sridhar K. N. Rao <sridhar.rao@spirent.com>
Diffstat (limited to 'tools/docker/results/README.md')
-rw-r--r--tools/docker/results/README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/tools/docker/results/README.md b/tools/docker/results/README.md
new file mode 100644
index 00000000..15d28b15
--- /dev/null
+++ b/tools/docker/results/README.md
@@ -0,0 +1,48 @@
+## Please set the limit on mmap counts equal to 262144 or more.
+
+There are two options. Run this command:
+```sh
+
+sysctl -w vm.max_map_count = 262144
+
+```
+or, to set it permanently, update the
+```sh
+
+vm.max_map_count
+
+```
+setting in
+
+```sh
+
+/etc/sysctl.conf
+
+```
+
+### Update the IP address.
+You may want to modify the IP address from 0.0.0.0 to appropriate host-ip in
+```sh
+docker-compose.yml
+
+```
+
+### Changes made to sebp/elk
+The vsperf/elk image is same as sebp/elk with a minor change - the inclusion of collectd codec to logstash.
+In the Dockerfile of sebp/elk, under logstash configuration, following lines are added:
+```sh
+ WORKDIR ${LOGSTASH_HOME}
+ RUN gosu logstash bin/logstash-plugin install logstash-codec-collectd
+ WORKDIR /
+
+```
+
+The resultsdb directory contains the source from Dovetail/Dovetail-webportal project.
+Once the results container is deployed, please run the python script as follows, to ensure that results can be pushed and queried correctly.
+```sh
+python init_db.py host_ip_address testapi_port
+```
+For example, if the host on which the container is running is 10.10.120.22, and container is exposing 8000 as the port, the command should be:
+```sh
+python init_db.py 10.10.120.22 8000
+```