Documentation on storage testcases in bottlenecks

JIRA: BOTTLENECK-216

This patch is used for user documentation on the 3 storage
stress testcases created in bottlnecks.

Change-Id: Ib560efea5bcd2decedf7d3f681ed303123ce31a9
Signed-off-by: Shubham Agarwal <shubham.agarwal.coder@gmail.com>

diff --git a/docs/testing/user/userguide/overview.rst b/docs/testing/user/userguide/overview.rst
index 746f24c..697191b 100644 (file)
--- a/docs/testing/user/userguide/overview.rst
+++ b/docs/testing/user/userguide/overview.rst
@@ -58,17 +58,23 @@ Integration Description
 
 Test suite & Test case Description
 ==================================
-+--------+-------------------------------------+
-|POSCA   | posca_factor_ping                   |
-|        +-------------------------------------+
-|        | posca_factor_system_bandwidth       |
-|        +-------------------------------------+
-|        | posca_facotor_soak_througputs       |
-|        +-------------------------------------+
-|        | posca_feature_vnf_scale_up          |
-|        +-------------------------------------+
-|        | posca_feature_vnf_scale_out         |
-+--------+-------------------------------------+
++--------+-------------------------------------------+
+|POSCA   | posca_factor_ping                         |
+|        +-------------------------------------------+
+|        | posca_factor_system_bandwidth             |
+|        +-------------------------------------------+
+|        | posca_facotor_soak_througputs             |
+|        +-------------------------------------------+
+|        | posca_feature_vnf_scale_up                |
+|        +-------------------------------------------+
+|        | posca_feature_vnf_scale_out               |
+|        +-------------------------------------------+
+|        | posca_factor_storperf                     |
+|        +-------------------------------------------+
+|        | posca_factor_multistack_storage_parallel  |
+|        +-------------------------------------------+
+|        | posca_factor_multistack_storage           |
++--------+-------------------------------------------+
 
 As for the abandoned test suite in the previous Bottlenecks releases, please
 refer to http://docs.opnfv.org/en/stable-danube/submodules/bottlenecks/docs/testing/user/userguide/deprecated.html.

diff --git a/docs/testing/user/userguide/posca/posca_factor_multistack_storage.rst b/docs/testing/user/userguide/posca/posca_factor_multistack_storage.rst
new file mode 100644 (file)
index 0000000..70f555d
--- /dev/null
+++ b/docs/testing/user/userguide/posca/posca_factor_multistack_storage.rst
@@ -0,0 +1,59 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Tech and others.
+
+***************************************************
+POSCA Stress (Factor) Test of Multistack Storage
+***************************************************
+
+Test Case
+========
+
++--------------------------------------------------------------------------------------+
+|Bottlenecks POSCA Stress Test MultiStack Storage                                      |
+|                                                                                      |
++--------------+-----------------------------------------------------------------------+
+|test case name| posca_factor_multistack_storage                                       |
+|              |                                                                       |
++--------------+-----------------------------------------------------------------------+
+|description   | Stress test regarding multistack storage using                        |
+|              | yardstick as a runner                                                 |
++--------------+-----------------------------------------------------------------------+
+|configuration | config file:                                                          |
+|              |   /testsuite/posca/testcase_cfg/posca_factor_multistack_storage.yaml  |
+|              |                                                                       |
+|              | stack number: 5, 10, 20, 50 ...                                       |
+|              |                                                                       |
++--------------+-----------------------------------------------------------------------+
+|test result   | Read / Write IOPS, Throughput, latency                                |
+|              |                                                                       |
++--------------+-----------------------------------------------------------------------+
+
+Configuration
+============
+::
+
+    load_manager:
+      scenarios:
+        tool: fio
+        test_times: 10
+        rw: write, read, rw, rr, randomrw
+        bs: 4k
+        size: 50g
+        rwmixwrite: 50
+        num_stack: 1, 3
+        volume_num: 1
+        numjobs: 1
+        direct: 1
+
+      contexts:
+        stack_create: yardstick
+        flavor:
+        yardstick_test_ip:
+        yardstick_test_dir: "samples"
+        yardstick_testcase: "storage_bottlenecks"
+
+    dashboard:
+      dashboard: "y"
+      dashboard_ip:

diff --git a/docs/testing/user/userguide/posca/posca_factor_multistack_storage_parallel.rst b/docs/testing/user/userguide/posca/posca_factor_multistack_storage_parallel.rst
new file mode 100644 (file)
index 0000000..f8343bd
--- /dev/null
+++ b/docs/testing/user/userguide/posca/posca_factor_multistack_storage_parallel.rst
@@ -0,0 +1,58 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Tech and others.
+
+***************************************************
+POSCA Stress (Factor) Test of Multistack Storage
+***************************************************
+
+Test Case
+========
+
++------------------------------------------------------------------------------------------------+
+|Bottlenecks POSCA Stress Test Storage (Multistack with Yardstick)                               |
+|                                                                                                |
++--------------+---------------------------------------------------------------------------------+
+|test case name| posca_factor_multistack_storage_parallel                                        |
+|              |                                                                                 |
++--------------+---------------------------------------------------------------------------------+
+|description   | Stress test regarding storage while using yardstick                             |
+|              | for multistack as a runner                                                      |
++--------------+---------------------------------------------------------------------------------+
+|configuration | config file:                                                                    |
+|              |   /testsuite/posca/testcase_cfg/posca_factor_multistack_storage_parallel.yaml   |
+|              |                                                                                 |
+|              |                                                                                 |
++--------------+---------------------------------------------------------------------------------+
+|test result   | Read / Write IOPS, Throughput, latency                                          |
+|              |                                                                                 |
++--------------+---------------------------------------------------------------------------------+
+
+Configuration
+============
+::
+
+    load_manager:
+      scenarios:
+        tool: fio
+        test_times: 10
+        rw: write, read, rw, rr, randomrw
+        bs: 4k
+        size: 50g
+        rwmixwrite: 50
+        num_stack: 1, 3
+        volume_num: 1
+        numjobs: 1
+        direct: 1
+
+      contexts:
+        stack_create: yardstick
+        flavor:
+        yardstick_test_ip:
+        yardstick_test_dir: "samples"
+        yardstick_testcase: "storage_bottlenecks"
+
+    dashboard:
+      dashboard: "y"
+      dashboard_ip:

diff --git a/docs/testing/user/userguide/posca/posca_factor_storperf.rst b/docs/testing/user/userguide/posca/posca_factor_storperf.rst
new file mode 100644 (file)
index 0000000..2dc9ecd
--- /dev/null
+++ b/docs/testing/user/userguide/posca/posca_factor_storperf.rst
@@ -0,0 +1,37 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Tech and others.
+
+***************************************************
+POSCA Stress Test of Storage Usage
+***************************************************
+
+Test Case
+========
+
++-----------------------------------------------------------------------------+
+|Bottlenecks POSCA Stress Test Storage                                        |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case name| posca_factor_storperf                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|description   | Stress test regarding storage using Storperf                 |
++--------------+--------------------------------------------------------------+
+|configuration | config file:                                                 |
+|              |   /testsuite/posca/testcase_cfg/posca_posca_storperf.yaml    |
+|              |                                                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test result   | Read / Write IOPS, Throughput, latency                       |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+
+Configuration
+============
+::
+
+    load_manager:
+      scenarios:
+        tool: storperf