aboutsummaryrefslogtreecommitdiffstats
path: root/tools/docker/results/README.md
diff options
context:
space:
mode:
authorSridhar Rao <sridhar.rao@spirent.com>2019-08-07 08:39:04 +0000
committerGerrit Code Review <gerrit@opnfv.org>2019-08-07 08:39:04 +0000
commit391e5ceb8958eff1f108cc2d589dd3a11c7c48a2 (patch)
tree9433aef428e9c4a27fdf16ad0f5edfda4fb8efdd /tools/docker/results/README.md
parentd835dbe3fd144c2144669cdf31a96263be21ab51 (diff)
parentd691cc89e106d710f4d36bc3998501415588e2e1 (diff)
Merge "Docker: VSPERF Results Container."
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
+```