X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2Ftesting%2Fdeveloper%2Fdevguide%2Fposca_guide.rst;h=ae6c248126930fb9cf8dc2a6b5d77e9bb8511fa8;hb=45d371c2a2d89231db9ffa892ce19da8f8b3cfa4;hp=fb3291fcb8958925094ea8ec72262d4a9797b298;hpb=cabe397fbb2cb062caf74cf165b7125c38c4f697;p=bottlenecks.git

diff --git a/docs/testing/developer/devguide/posca_guide.rst b/docs/testing/developer/devguide/posca_guide.rst
index fb3291fc..ae6c2481 100644
--- a/docs/testing/developer/devguide/posca_guide.rst
+++ b/docs/testing/developer/devguide/posca_guide.rst
@@ -38,6 +38,7 @@ Detailed workflow is illutrated below.
 
 * https://wiki.opnfv.org/display/bottlenecks
 
+
 Preinstall Packages
 ====================
 
@@ -63,6 +64,7 @@ A few steps are needed to run it locally.
 
 It is presumed that a user is using Compass4nfv to deploy OPNFV Danube and the user logins jumper server as root.
 
+
 Downloading Bottlenecks Software
 --------------------------------
 
@@ -73,6 +75,7 @@ Downloading Bottlenecks Software
     git clone https://gerrit.opnfv.org/gerrit/bottlenecks
     cd bottlenecks
 
+
 Preparing Python Virtual Evnironment
 ------------------------------------
 
@@ -80,6 +83,7 @@ Preparing Python Virtual Evnironment
 
     . pre_virt_env.sh
 
+
 Excuting Specified Testcase
 ---------------------------
 
@@ -111,6 +115,14 @@ The second is using python interpreter.
     docker exec bottleneckcompose_bottlenecks_1 python ${POSCA_SCRIPT}/run_posca.py [testcase <testcase>] [teststory <teststory>]
 
 
+Showing Report
+--------------
+
+Bottlenecks uses ELK to illustrate the testing results.
+Asumming IP of the SUT (System Under Test) is denoted as ipaddr,
+then the address of Kibana is http://[ipaddr]:5601. One can visit this address to see the illustrations.
+Address for elasticsearch is http://[ipaddr]:9200. One can use any Rest Tool to visit the testing data stored in elasticsearch.
+
 Cleaning Up Environment
 -----------------------
 
@@ -119,9 +131,44 @@ Cleaning Up Environment
     . rm_virt_env.sh
 
 
+If you want to clean the dockers that established during the test, you can excute the additional commands below.
+
+.. code-block:: bash
+
+    docker-compose -f docker/bottleneck-compose/docker-compose.yml down -d
+    docker ps -a | grep 'influxdb' | awk '{print $1}' | xargs docker rm -f >/dev/stdout
+
+Or you can just run the following command
+
+.. code-block:: bash
+
+    bash run_tests.sh --cleanup
+
+Note that you can also add cleanup parameter when you run a test case. Then environment will be automatically cleaned up when
+completing the test.
+
 Run POSCA through Community CI
 ==============================
-* POSCA test cases are runned by OPNFV CI now. See https://build.opnfv.org for more information.
+POSCA test cases are runned by OPNFV CI now. See https://build.opnfv.org for details of the building jobs.
+Each building job is set up to execute a single test case. The test results/logs will be printed on the web page and
+reported automatically to community MongoDB. There are two ways to report the results.
+
+1. Report testing result by shell script
+
+.. code-block:: bash
+
+    bash run_tests.sh [-h|--help] [-s <testsuite>] [-c <testcase>] --report
+
+2. Report testing result by python interpreter
+
+.. code-block:: bash
+
+    docker-compose -f docker/bottleneck-compose/docker-compose.yml up -d
+    docker pull tutum/influxdb:0.13
+    sleep 5
+    REPORT="True"
+    POSCA_SCRIPT="/home/opnfv/bottlenecks/testsuites/posca"
+    docker exec bottleneckcompose_bottlenecks_1 python ${POSCA_SCRIPT}/run_posca.py [testcase <testcase>] [teststory <teststory>] REPORT
 
 Test Result Description
 =======================