From bd80bcfb59a948d47af4d970f2832e8079f5f0f0 Mon Sep 17 00:00:00 2001 From: yuyang Date: Wed, 8 Mar 2017 11:17:40 +0800 Subject: Apply docs strucutre to Danube agreement JIRA: BOTTLENECK-137 According to the agreement in Testperf meeting. Change the structure of docs. Change-Id: Ie370de1e7a24c918aedc8a2cdb2cca0508ef4257 Signed-off-by: yuyang --- docs/testing/developer/dashboard_guide.rst | 21 ++ docs/testing/developer/index.rst | 16 ++ docs/testing/developer/overview.rst | 94 +++++++++ docs/testing/developer/posca_guide.rst | 56 ++++++ docs/testing/developer/rubbos_guide.rst | 128 ++++++++++++ docs/testing/developer/vstf_guide.rst | 241 +++++++++++++++++++++++ docs/testing/index.rst | 46 +++++ docs/testing/user/index.rst | 29 +++ docs/testing/user/posca/posca_stress_ping.rst | 52 +++++ docs/testing/user/posca/posca_stress_traffic.rst | 49 +++++ docs/testing/user/rubbos/rubbos_basic.rst | 30 +++ docs/testing/user/rubbos/rubbos_heavy_tc1101.rst | 30 +++ docs/testing/user/rubbos/rubbos_tc1101.rst | 30 +++ docs/testing/user/rubbos/rubbos_tc1201.rst | 30 +++ docs/testing/user/rubbos/rubbos_tc1301.rst | 30 +++ docs/testing/user/rubbos/rubbos_tc1401.rst | 30 +++ docs/testing/user/vstf/vstf_Ti1.rst | 28 +++ docs/testing/user/vstf/vstf_Ti2.rst | 28 +++ docs/testing/user/vstf/vstf_Ti3.rst | 28 +++ docs/testing/user/vstf/vstf_Tn1.rst | 28 +++ docs/testing/user/vstf/vstf_Tn2.rst | 28 +++ docs/testing/user/vstf/vstf_Tu1.rst | 28 +++ docs/testing/user/vstf/vstf_Tu2.rst | 28 +++ docs/testing/user/vstf/vstf_Tu3.rst | 28 +++ 24 files changed, 1136 insertions(+) create mode 100644 docs/testing/developer/dashboard_guide.rst create mode 100644 docs/testing/developer/index.rst create mode 100644 docs/testing/developer/overview.rst create mode 100644 docs/testing/developer/posca_guide.rst create mode 100644 docs/testing/developer/rubbos_guide.rst create mode 100644 docs/testing/developer/vstf_guide.rst create mode 100644 docs/testing/index.rst create mode 100644 docs/testing/user/index.rst create mode 100644 docs/testing/user/posca/posca_stress_ping.rst create mode 100644 docs/testing/user/posca/posca_stress_traffic.rst create mode 100644 docs/testing/user/rubbos/rubbos_basic.rst create mode 100644 docs/testing/user/rubbos/rubbos_heavy_tc1101.rst create mode 100644 docs/testing/user/rubbos/rubbos_tc1101.rst create mode 100644 docs/testing/user/rubbos/rubbos_tc1201.rst create mode 100644 docs/testing/user/rubbos/rubbos_tc1301.rst create mode 100644 docs/testing/user/rubbos/rubbos_tc1401.rst create mode 100644 docs/testing/user/vstf/vstf_Ti1.rst create mode 100644 docs/testing/user/vstf/vstf_Ti2.rst create mode 100644 docs/testing/user/vstf/vstf_Ti3.rst create mode 100644 docs/testing/user/vstf/vstf_Tn1.rst create mode 100644 docs/testing/user/vstf/vstf_Tn2.rst create mode 100644 docs/testing/user/vstf/vstf_Tu1.rst create mode 100644 docs/testing/user/vstf/vstf_Tu2.rst create mode 100644 docs/testing/user/vstf/vstf_Tu3.rst (limited to 'docs/testing') diff --git a/docs/testing/developer/dashboard_guide.rst b/docs/testing/developer/dashboard_guide.rst new file mode 100644 index 00000000..5679e508 --- /dev/null +++ b/docs/testing/developer/dashboard_guide.rst @@ -0,0 +1,21 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +************** +Dashbard guide +************** + +Scope +===== +This document provides an overview of the results of test cases developed by +the OPNFV Bottlenecks Project, executed on OPNFV community labs. + +OPNFV CI(Continous Integration) system provides automated build, deploy and testing for +the software developed in OPNFV. Unless stated, the reported tests are +automated via Jenkins Jobs. + +Test results are visible in the following dashboard: + +* *Testing dashboard*: uses Mongo DB to store test results and Bitergia for + visualization, which includes the rubbos test result, vstf test result. diff --git a/docs/testing/developer/index.rst b/docs/testing/developer/index.rst new file mode 100644 index 00000000..20cc00eb --- /dev/null +++ b/docs/testing/developer/index.rst @@ -0,0 +1,16 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +*************************** +Bottlenecks - Testing Guide +*************************** + +.. toctree:: + :maxdepth: 2 + + ./overview.rst + ./posca_guide.rst + ./rubbos_guide.rst + ./vstf_guide.rst + ./dashboard_guide.rst diff --git a/docs/testing/developer/overview.rst b/docs/testing/developer/overview.rst new file mode 100644 index 00000000..8bc1b7c1 --- /dev/null +++ b/docs/testing/developer/overview.rst @@ -0,0 +1,94 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +********************* +Project Testing Guide +********************* + +For each *test suite*, you can either setup *test story* or *test case* to run +certain test. *test story* could include several *test cases* as a set in one +configuration file. You could then call the *test story* or *test case* by using +Bottlencks CLI or Python build process. +Details will be shown in the following section. + +Brief Introdcution of the Test suites in Project Releases +============================================================= + +Brahmaputra: rubbos is introduced, which is an end2end NFVI perforamnce tool. +Virtual switch test framework(VSTF) is also introduced, +which is an test framework used for vswitch performance test. + +Colorado: rubbos is refactored by using puppet, which makes it quite flexible +to configure with different number of load generator(Client), worker(tomcat). +vstf is refactored by extracting the test case's configuration information. + +Danube: posca testsuite is introduced to implementing stress (factor), scenario and +tuning test in parametric manner. Two testcases are developed and integrated into +community CI pipeline. + +Integration Description +======================= ++-------------+----------------------+----------------------+ +| Release | integrated installer | Supported Testsuite | ++-------------+----------------------+----------------------+ +| Brahmaputra | Fuel | Rubbos, VSTF | ++-------------+----------------------+----------------------+ +| Colorado | Compass | Rubbos, VSTF | ++-------------+----------------------+----------------------+ +| Danube | Compass | POSCA | ++-------------+----------------------+----------------------+ + +Test suite & Test case Description +================================== ++--------+-------------------------------+ +|Rubbos | rubbos_basic | +| +-------------------------------+ +| | rubbos_TC1101 | +| +-------------------------------+ +| | rubbos_TC1201 | +| +-------------------------------+ +| | rubbos_TC1301 | +| +-------------------------------+ +| | rubbos_TC1401 | +| +-------------------------------+ +| | rubbos_heavy_TC1101 | ++--------+-------------------------------+ +|vstf | vstf_Ti1 | +| +-------------------------------+ +| | vstf_Ti2 | +| +-------------------------------+ +| | vstf_Ti3 | +| +-------------------------------+ +| | vstf_Tn1 | +| +-------------------------------+ +| | vstf_Tn2 | +| +-------------------------------+ +| | vstf_Tu1 | +| +-------------------------------+ +| | vstf_Tu2 | +| +-------------------------------+ +| | vstf_Tu3 | ++--------+-------------------------------+ +|posca | posca_stress_ping | +| +-------------------------------+ +| | posca_stress_traffic | +| | | +| | (posca_factor_sys_bandwidth) | ++--------+-------------------------------+ + +Installation of Testsuites +========================== + +* TODO + +Setting Up Configrations +======================== + +* TODO + +Run Tests Brief +=============== + +* TODO +* More will be shown in the platform overview diff --git a/docs/testing/developer/posca_guide.rst b/docs/testing/developer/posca_guide.rst new file mode 100644 index 00000000..dbc7568c --- /dev/null +++ b/docs/testing/developer/posca_guide.rst @@ -0,0 +1,56 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +********************* +POSCA Testsuite Guide +********************* + + +POSCA Introduction +==================== +The POSCA (Parametric Bottlenecks Testing Catalogue) testsuite +classifies the bottlenecks test cases and results into 5 categories. +Then the results will be analyzed and bottlenecks will be searched +among these categories. + +The POSCA testsuite aims to locate the bottlenecks in parmetric +manner and to decouple the bottlenecks regarding the deployment +requirements. +The POSCA testsuite provides an user friendly way to profile and +understand the E2E system behavior and deployment requirements. + +Goals of the POSCA testsuite: + a) Automatically locate the bottlenecks in a iterative manner. + b) Automatically generate the testing report for bottlenecks in +different categories. + c) Implementing Automated Staging. + +Scopes of the POSCA testsuite: + a) Modeling, Testing and Test Result analysis. + b) Parameters choosing and Algorithms. + +Test stories of POSCA testsuite: + a) Factor test (Stress test): base test cases that Feature test and Optimization will be +dependant on. + b) Feature test: test cases for features/scenarios. + c) Optimization test: test to tune the system parameter. + +Detailed workflow is illutrated below. +* TODO Add image here + +Preinstall Packages +==================== +* TODO Description of dependent packages + +Run POSCA Locally +================= +* TO Description of POSCA testing steps + +Run POSCA through Community CI +============================== +* TODO Description of POSCA integrated into CI system + +Test Result Description +======================= +* TODO hwo to access the test result diff --git a/docs/testing/developer/rubbos_guide.rst b/docs/testing/developer/rubbos_guide.rst new file mode 100644 index 00000000..4d92d2e2 --- /dev/null +++ b/docs/testing/developer/rubbos_guide.rst @@ -0,0 +1,128 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +********************** +Rubbos Testsuite Guide +********************** + + +Rubbos Introduction +==================== +Rubbos is a bulletin board benchmark modeled after an online news forum like Slashdot. +It is an open source Middleware and an n-tier system model which +is used to be deployed on multiple physical node and +to measure the whole performacne of OPNFV platform. +Rubbos can deploy the Apache, tomcat, and DB. +Based on the deployment, rubbos gives the pressure to the whole system. +When the system reaches to the peak, the throughput will not grow more. +This testcase can help to understand the bottlenecks of OPNFV plantform +and improve the performance of OPNFV platform. + +Detailed workflow is illutrated below. + +.. image:: ../images/Framework_Setup.png + :width: 770px + :alt: Bottlenecks Framework Setup + +Preinstall Packages +==================== +There is a need to install some packages before running the rubbos, +gcc, gettext, g++, libaio1, libaio-dev, make and git are necessary. +When the rubbos runs on the OPNFV community continuous integration(CI) +system, the required packages are installed automately as shown in the +code repository, which is /utils/infra_setup/vm_dev_setup/packages.conf, +besides, the packages can be encapsulated in the images initially. +If someone wants to use rubbos locally, he/she has to install them by +hand, such as in ubuntu 14.04, + +.. code-block:: bash + + apt-get update + apt-get install gettext + +How does Rubbos Integrate into Installers +========================================= +1.Community CI System + +Rubbos has been successfully integrated into fuel and compass with NOSDN scenario +in OPNFV community CI system. + +Heat is used to create 9 instances, which is shown in +/utils/infra_setup/heat_template/HOT_create_instance.sh, the 9 instances are used +for installing Apache, Tomcat, Mysql, Control, Benchmark and 4 Clients. The tools, +such as rubbos, sysstat, oprofile, etc, are installed in these instances to perform +the test, the test results are stored in the Benchmark instance initially, then they +are copied to the Rubbos_result instance, finally, the test results are transferred to +the community dashboard. + +There's a need to store our pakages as large as M bytes or G bytes size, such as +the images, jdk, apache-ant, apache-tomcat, etc, the OPNFV community storage system, +Google Cloud Storage, is used, the pakages can be downloaded from +https://artifacts.opnfv.org/bottlenecks/rubbos. + +2.Local Deployment + +If someone wants to run the rubbos in his own environment, he/she can keep to the following steps, + +2.1 Start up instances by using heat, nova or libvert. In Openstack Environemnt, +the heat script can refer /utils/infra_setup/heat_template/HOT_create_instance.sh, +if the openstack doesn't support heat module, +the script /utils/infra_setup/create_instance.sh can be used. +Without Openstack, there's a way to set up instances by using libvert, the scripts are shown under +the directory /utils/rubbos_dev_env_setup. + +The image can be downloaded from the community cloud storage + +.. code-block:: bash + + curl --connect-timeout 10 -o bottlenecks-trusty-server.img + http://artifacts.opnfv.org/bottlenecks/rubbos/bottlenecks-trusty-server.img + +2.2 Ssh into the control node and clone the bottlenecks codes to the root directory. + +.. code-block:: bash + + git clone https://git.opnfv.org/bottlenecks /bottlenecks + +2.3 Download the packages and decompress them into the proper directory. + +.. code-block:: bash + + curl --connect-timeout 10 -o app_tools.tar.gz + http://artifacts.opnfv.org/bottlenecks/rubbos/app_tools.tar.gz + curl --connect-timeout 10 -o rubbosMulini6.tar.gz + http://artifacts.opnfv.org/bottlenecks/rubbos/rubbosMulini6.tar.gz + +.. code-block:: bash + + tar zxf app_tools.tar.gz -C /bottlenecks/rubbos + tar zxf rubbosMulini6.tar.gz -C /bottlenecks/rubbos/rubbos_scripts + +2.4 Ssh into the Control node and run the script + +.. code-block:: bash + + source /bottlenecks/rubbos/rubbos_scripts/1-1-1/scripts/run.sh + +2.5 Check the test results under the directory /bottlenecks/rubbos/rubbos_results in +Control node. The results are stored in the format of xml, +move them to the brower chrome, then you can see the results. + +Test Result Description +======================= +In OPNFV community, the result is shown in the following format + +:: + + [{'client': 200, 'throughput': 27}, + {'client': 700, 'throughput': 102}, + {'client': 1200, 'throughput': 177}, + {'client': 1700, 'throughput': 252}, + {'client': 2200, 'throughput': 323}, + {'client': 2700, 'throughput': 399}, + {'client': 3200, 'throughput': 473}] + +The results are transferred to the community database and a map is drawed on the dashboard. +Along with the growth of the number of the client, the throughput grows at first, then meets +up with a point of inflexion, which is caused by the bottlenecks of the measured system. diff --git a/docs/testing/developer/vstf_guide.rst b/docs/testing/developer/vstf_guide.rst new file mode 100644 index 00000000..e1ad5f2b --- /dev/null +++ b/docs/testing/developer/vstf_guide.rst @@ -0,0 +1,241 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +******************** +VSTF Testsuite Guide +******************** + +VSTF Introduction +==================== +VSTF(Virtual Switch Test Framework) is a system-level testing framework in the +area of network virtualization, and it could help you estimate the system switch +ability and find out the network bottlenecks by main KPIs(bandwidth, latency, +resource usage and so on), VSTF owns a methodology to define the test scenario and +testcases, Now we could support Tu testcases in the Openstack environment, More +scenarios and cases will be added. + +VSTF TestScenario +----------------- +1. Tu - VM to VM +2. Tn - Physical Nic loopback +3. TnV - VNF loopback +4. Ti - VM to Physical Nic + +Pre-install Packages on the ubuntu 14.04 VM +=========================================== +VSTF VM Preparation Steps +------------------------- +1. Create a ubuntu 14.04 VM +2. Install dependency inside VM +3. Install vstf python package inside VM + +VM preparation +-------------- +Install python2.7 version and git + +:: + + sudo apt-get install python2.7 + sudo apt-get install git + +Download Bottlenecks package + +:: + + sudo cd /home/ + sudo git clone https://gerrit.opnfv.org/gerrit/bottlenecks + +Install the dependency + +:: + + sudo apt-get install python-pip + sudo pip install --upgrade pip + sudo dpkg-reconfigure dash + sudo apt-get install libjpeg-dev + sudo apt-get install libpng-dev + sudo apt-get install python-dev + sudo apt-get install python-testrepository + sudo apt-get install git + sudo apt-get install python-pika + sudo apt-get install python-oslo.config + sudo pip install -r /home/bottlenecks/vstf/requirements.txt + +Install vstf package + +:: + + sudo mkdir -p /var/log/vstf/ + sudo cp -r /home/bottlenecks/vstf/etc/vstf/ /etc/ + sudo mkdir -p /opt/vstf/ + sudo cd /home/bottlenecks;sudo rm -rf build/ + sudo python setup.py install + +Image on the Cloud +------------------ ++-----------+-------------------------------------------------------------+ +| Name | vstf-image | ++===========+=============================================================+ +| URL | http://artifacts.opnfv.org/bottlenecks/vstf-manager-new.img | ++-----------+-------------------------------------------------------------+ +| Format | QCOW2 | ++-----------+-------------------------------------------------------------+ +| Size | 5G | ++-----------+-------------------------------------------------------------+ +| User | root | ++-----------+-------------------------------------------------------------+ +| Passwd | root | ++-----------+-------------------------------------------------------------+ +There is a complete vstf image on the cloud ,you could download it and use it to +deploy and run cases ,but do not need VM preparation steps. + + +How is VSTF Integrated into Installers +======================================== +VM requirements +--------------- ++------------------+----------+--------------------+-----------------------------------------------------+ +| Name | FLAVOR | IMAGE_NAME | NETWORK | ++==================+==========+====================+=====================================================+ +| vstf-manager | m1.large | vstf-image | control-plane=XX.XX.XX.XX | ++------------------+----------+--------------------+-----------------------------------------------------+ +| vstf-tester | m1.large | vstf-image | control-plane(eth0)=XX.XX.XX.XX | +| | | | test-plane(eth1)=XX.XX.XX.XX | ++------------------+----------+--------------------+-----------------------------------------------------+ +| vstf-target | m1.large | vstf-image | control-plane(eth0)=XX.XX.XX.XX | +| | | | test-plane(eth1)=XX.XX.XX.XX | ++------------------+----------+--------------------+-----------------------------------------------------+ +m1.large means 4U4G for the target image Size 5GB +For the network used by VMs,network need two plane ,one plane is control plane and the other plane is test plane. + +OPNFV community Usage in the CI system +-------------------------------------- ++---------------------------------------+---------------------------------------+ +| Project Name | Project Categoty | ++=======================================+=======================================+ +| bottlenecks-daily-fuel-vstf-lf-master | bottlenecks | ++---------------------------------------+---------------------------------------+ +OPNFV community jenkins Project info + +Main Entrance for the ci test: + +:: + + cd /home/bottlenecks/ci; + bash -x vstf_run.sh + +Test on local(Openstack Environment) +------------------------------------ +download the image file + +:: + + curl --connect-timeout 10 -o /tmp/vstf-manager.img \ + http://artifacts.opnfv.org/bottlenecks/vstf-manager-new.img -v + +create the image file by the glance + +:: + + glance image-create --name $MANAGER_IMAGE_NAME \ + --disk-format qcow2 \ + --container-format bare \ + --file /tmp/vstf-manager.img + +create the keypair for the image(anyone will be ok) + +:: + + cd /home/bottlenecks/utils/infra_setup/bottlenecks_key + nova keypair-add --pub_key $KEY_PATH/bottlenecks_key.pub $KEY_NAME + +create the vstf three VMs in the openstack by heat + +:: + + cd /home/bottlenecks/utils/infra_setup/heat_template/vstf_heat_template + heat stack-create vstf -f bottleneck_vstf.yaml + +launch the vstf process inside the vstf-manager vstf-tester vstf-target VMs + +:: + + cd /home/bottlenecks/utils/infra_setup/heat_template/vstf_heat_template + bash -x launch_vstf.sh + +edit the test scenario and test packet list in the vstf_test.sh, now support the Tu-1/2/3 + +:: + + function fn_testing_scenario(){ + ... + local test_length_list="64 128 256 512 1024" + local test_scenario_list="Tu-1 Tu-3" + ... + } + +launch the vstf script + +:: + + cd /home/bottlenecks/utils/infra_setup/heat_template/vstf_heat_template + bash -x vstf_test.sh + +Test Result Description +======================= +Result Format +------------- +For example after the test, The result will display as the following format + +:: + + { u'64': { u'AverageLatency': 0.063, + u'Bandwidth': 0.239, + u'CPU': 0.0, + u'Duration': 20, + u'MaximumLatency': 0.063, + u'MinimumLatency': 0.063, + u'MppspGhz': 0, + u'OfferedLoad': 100.0, + u'PercentLoss': 22.42, + u'RxFrameCount': 4309750.0, + u'RxMbps': 198.28, + u'TxFrameCount': 5555436.0, + u'TxMbps': 230.03}} + +Option Description +------------------ ++---------------------+---------------------------------------------------+ +| Option Name | Description | ++=====================+===================================================+ +| AverageLatency | The average latency data during the packet | +| | transmission (Unit:microsecond) | ++---------------------+---------------------------------------------------+ +| Bandwidth | Network bandwidth(Unit:Million packets per second)| ++---------------------+---------------------------------------------------+ +| CPU | Total Resource Cpu usage(Unit: Ghz) | ++---------------------+---------------------------------------------------+ +| Duration | Test time(Unit: second) | ++---------------------+---------------------------------------------------+ +| MaximumLatency | The maximum packet latency during the packet | +| | transmission (Unit:microsecond) | ++---------------------+---------------------------------------------------+ +| MinimumLatency | The maximum packet latency during the packet | +| | transmission (Unit:microsecond) | ++---------------------+---------------------------------------------------+ +| MppspGhz | Million Packets per second with per CPU | +| | resource Ghz(Unit: Mpps/Ghz) | ++---------------------+---------------------------------------------------+ +| OfferedLoad | The load of network offered | ++---------------------+---------------------------------------------------+ +| PercentLoss | The percent of frame loss rate | ++---------------------+---------------------------------------------------+ +| RxFrameCount | The total frame on Nic rx | ++---------------------+---------------------------------------------------+ +| RxMbps | The received bandwidth per second | ++---------------------+---------------------------------------------------+ +| TxFrameCount | The total frame on Nic rx | ++---------------------+---------------------------------------------------+ +| TxMbps | The send bandwidth per second | ++---------------------+---------------------------------------------------+ diff --git a/docs/testing/index.rst b/docs/testing/index.rst new file mode 100644 index 00000000..70d3983b --- /dev/null +++ b/docs/testing/index.rst @@ -0,0 +1,46 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Huawei Technologies Co.,Ltd and others. + +************************ +Bottlenecks Introduction +************************ + +**Welcome to Bottlenecks' documentation !** + +.. _Bottlenecks: https://wiki.opnfv.org/bottlenecks +.. _Proposal: https://wiki.opnfv.org/download/attachments/2926187/bottlenecks_project_for_test_meeting_20150820.pptx?version=1&modificationDate=1458849192000&api=v2 + +Bottlenecks_ is an OPNFV testing Project. + +The project's goal is to find system bottlenecks by testing and verifying +OPNFV infrastructure in a staging environment before committing it to a production environment. +Instead of debugging a deployment in production environment, +an automatic method for executing benchmarks which plans to +validate the deployment during staging is adopted. +This project forms a staging framework to find bottlenecks and to do analysis of the OPNFV infrastructure. + +The *Bottlenecks* framework is deployed in several OPNFV community labs. It is +installer, infrastructure and application independent. + +.. toctree:: + :glob: + + developer/index.rst + user/index.rst + * + +.. _Pharos: https://wiki.opnfv.org/pharos + +.. seealso:: Pharos_ for information on OPNFV community labs. + +Proposal_ for more project information. + +Contact Bottlenecks +=================== + +Feedback `Contact us`_ + +.. _Contact us: opnfv-users@lists.opnfv.org + + diff --git a/docs/testing/user/index.rst b/docs/testing/user/index.rst new file mode 100644 index 00000000..8afd57ab --- /dev/null +++ b/docs/testing/user/index.rst @@ -0,0 +1,29 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +************************** +Bottlenecks - User Guide +************************** + +.. This index.rst file is used to structure and organise the content in these directories. +.. The documentation toolchain will create web and pdf versions of the content of this file. + +.. toctree:: + :maxdepth: 2 + + ./rubbos/rubbos_basic.rst + ./rubbos/rubbos_tc1101.rst + ./rubbos/rubbos_tc1201.rst + ./rubbos/rubbos_tc1301.rst + ./rubbos/rubbos_tc1401.rst + ./rubbos/rubbos_heavy_tc1101.rst + ./vstf/vstf_Ti1.rst + ./vstf/vstf_Ti2.rst + ./vstf/vstf_Ti3.rst + ./vstf/vstf_Tn1.rst + ./vstf/vstf_Tn2.rst + ./vstf/vstf_Tu1.rst + ./vstf/vstf_Tu2.rst + ./vstf/vstf_Tu3.rst + ./posca/posca_stress_ping.rst + ./posca/posca_stress_traffic.rst diff --git a/docs/testing/user/posca/posca_stress_ping.rst b/docs/testing/user/posca/posca_stress_ping.rst new file mode 100644 index 00000000..846b4686 --- /dev/null +++ b/docs/testing/user/posca/posca_stress_ping.rst @@ -0,0 +1,52 @@ +.. 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 Perfomance Life-Cycle +*************************************************** + +Test Case +======== + ++-----------------------------------------------------------------------------+ +|Bottlenecks POSCA Stress Test Ping | +| | ++--------------+--------------------------------------------------------------+ +|test case name| posca_stress_ping | +| | | ++--------------+--------------------------------------------------------------+ +|description | Stress test regarding perfomance life-cycle while using ping | +| | to validate the VM pairs constructions | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/posca/testcase_cfg/posca_stress_ping | +| | | +| | stack number: 5, 10, 20, 50 ... | +| | | ++--------------+--------------------------------------------------------------+ +|test result | PKT loss rate, success rate, test time, latency | +| | | ++--------------+--------------------------------------------------------------+ + +Configuration +============ +load_manager: + scenarios: + tool: ping + test_times: 100 + package_size: + num_stack: 2, 5, 10 + package_loss: 10% + + contexts: + stack_create: yardstick + flavor: + yardstick_test_ip: + yardstick_test_dir: "samples" + yardstick_testcase: "ping_bottlenecks" + +dashboard: + dashboard: "y" + dashboard_ip: diff --git a/docs/testing/user/posca/posca_stress_traffic.rst b/docs/testing/user/posca/posca_stress_traffic.rst new file mode 100644 index 00000000..a995996e --- /dev/null +++ b/docs/testing/user/posca/posca_stress_traffic.rst @@ -0,0 +1,49 @@ +.. 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 System bandwidth +********************************************** + + +Test Case +======== ++-----------------------------------------------------------------------------+ +|Bottlenecks POSCA Stress Test Traffic | +| | ++--------------+--------------------------------------------------------------+ +|test case name| posca_stress_ping | +| | | ++--------------+--------------------------------------------------------------+ +|description | Stress test regarding baseline of the system for a single | +| | user, i.e., a VM pair while increasing the package size | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/posca/testcase_cfg/posca_factor_system_bandwith | +| | | +| | stack number: 1 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | PKT loss rate, latency, throupht, cpu usage | +| | | ++--------------+--------------------------------------------------------------+ + +Configration +=========== +test_config: + tool: netperf + protocol: tcp + test_time: 20 + tx_pkt_sizes: 64, 256, 1024, 4096, 8192, 16384, 32768, 65536 + rx_pkt_sizes: 64, 256, 1024, 4096, 8192, 16384, 32768, 65536 + cpu_load: 0.9 + latency: 100000 +runner_config: + dashboard: "y" + dashboard_ip: + stack_create: yardstick + yardstick_test_ip: + yardstick_test_dir: "samples" + yardstick_testcase: "netperf_bottlenecks" diff --git a/docs/testing/user/rubbos/rubbos_basic.rst b/docs/testing/user/rubbos/rubbos_basic.rst new file mode 100644 index 00000000..ffef6c48 --- /dev/null +++ b/docs/testing/user/rubbos/rubbos_basic.rst @@ -0,0 +1,30 @@ +.. 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. + +************************************************ +Bottlenecks Rubbos Test Case Description Basic +************************************************ + + ++-----------------------------------------------------------------------------+ +|Bottlenecks Rubbos Basic | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_rubbos_Basic | +| | | ++--------------+--------------------------------------------------------------+ +|description | Rubbos platform for 1 tomcat, 1 Apache and 1 mysql. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/rubbos/testcase_cfg/rubbos_basic.yaml | +| | | +| | client number: 1 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/rubbos/rubbos_heavy_tc1101.rst b/docs/testing/user/rubbos/rubbos_heavy_tc1101.rst new file mode 100644 index 00000000..08251c7b --- /dev/null +++ b/docs/testing/user/rubbos/rubbos_heavy_tc1101.rst @@ -0,0 +1,30 @@ +.. 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. + +****************************************************** +Bottlenecks Rubbos Test Case Description Heavy TC1101 +****************************************************** + + ++-----------------------------------------------------------------------------+ +|Bottlenecks Rubbos TC Heavy1101 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_rubbos_heavy_tc1101 | +| | | ++--------------+--------------------------------------------------------------+ +|description | Rubbos platform for 1 tomcat, 1 Apache and 1 mysql. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/rubbos/testcase_cfg/rubbos-heavy_1-1-0-1.yaml | +| | | +| | client number: 10 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/rubbos/rubbos_tc1101.rst b/docs/testing/user/rubbos/rubbos_tc1101.rst new file mode 100644 index 00000000..2a261313 --- /dev/null +++ b/docs/testing/user/rubbos/rubbos_tc1101.rst @@ -0,0 +1,30 @@ +.. 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. + +************************************************ +Bottlenecks Rubbos Test Case Description TC1101 +************************************************ + + ++-----------------------------------------------------------------------------+ +|Bottlenecks Rubbos TC1101 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_rubbos_tc1101 | +| | | ++--------------+--------------------------------------------------------------+ +|description | Rubbos platform for 1 tomcat, 1 Apache and 1 mysql. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/rubbos/testcase_cfg/rubbos_1-1-0-1.yaml | +| | | +| | client number: 5 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/rubbos/rubbos_tc1201.rst b/docs/testing/user/rubbos/rubbos_tc1201.rst new file mode 100644 index 00000000..9b6a5f99 --- /dev/null +++ b/docs/testing/user/rubbos/rubbos_tc1201.rst @@ -0,0 +1,30 @@ +.. 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. + +************************************************ +Bottlenecks Rubbos Test Case Description TC1201 +************************************************ + + ++-----------------------------------------------------------------------------+ +|Bottlenecks Rubbos TC1201 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_rubbos_tc1201 | +| | | ++--------------+--------------------------------------------------------------+ +|description | Rubbos platform for 1 Apache, 2 tomcat and 1 mysql. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/rubbos/testcase_cfg/rubbos_1-2-0-1.yaml | +| | | +| | client number: 5 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/rubbos/rubbos_tc1301.rst b/docs/testing/user/rubbos/rubbos_tc1301.rst new file mode 100644 index 00000000..db4e0b63 --- /dev/null +++ b/docs/testing/user/rubbos/rubbos_tc1301.rst @@ -0,0 +1,30 @@ +.. 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. + +************************************************ +Bottlenecks Rubbos Test Case Description TC1301 +************************************************ + + ++-----------------------------------------------------------------------------+ +|Bottlenecks Rubbos TC1301 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_rubbos_tc1301 | +| | | ++--------------+--------------------------------------------------------------+ +|description | Rubbos platform for 1 Apache, 3 tomcat and 1 mysql. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/rubbos/testcase_cfg/rubbos_1-3-0-1.yaml | +| | | +| | client number: 5 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/rubbos/rubbos_tc1401.rst b/docs/testing/user/rubbos/rubbos_tc1401.rst new file mode 100644 index 00000000..f195d237 --- /dev/null +++ b/docs/testing/user/rubbos/rubbos_tc1401.rst @@ -0,0 +1,30 @@ +.. 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. + +************************************************ +Bottlenecks Rubbos Test Case Description TC1401 +************************************************ + + ++-----------------------------------------------------------------------------+ +|Bottlenecks Rubbos TC1401 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_rubbos_tc1401 | +| | | ++--------------+--------------------------------------------------------------+ +|description | Rubbos platform for 1 Apache, 4 tomcat and 1 mysql. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/rubbos/testcase_cfg/rubbos_1-4-0-1.yaml | +| | | +| | client number: 5 | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Ti1.rst b/docs/testing/user/vstf/vstf_Ti1.rst new file mode 100644 index 00000000..ce1690b4 --- /dev/null +++ b/docs/testing/user/vstf/vstf_Ti1.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Ti1 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Ti1 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Ti1 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Ti1. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Ti1.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Ti2.rst b/docs/testing/user/vstf/vstf_Ti2.rst new file mode 100644 index 00000000..58cb40f7 --- /dev/null +++ b/docs/testing/user/vstf/vstf_Ti2.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Ti2 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Ti2 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Ti2 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Ti2. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Ti2.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Ti3.rst b/docs/testing/user/vstf/vstf_Ti3.rst new file mode 100644 index 00000000..3bb9dfce --- /dev/null +++ b/docs/testing/user/vstf/vstf_Ti3.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Ti3 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Ti3 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Ti3 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Ti3. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Ti3.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Tn1.rst b/docs/testing/user/vstf/vstf_Tn1.rst new file mode 100644 index 00000000..5c591a9b --- /dev/null +++ b/docs/testing/user/vstf/vstf_Tn1.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Tn1 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Tn1 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Tn1 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Tn1. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Tn1.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Tn2.rst b/docs/testing/user/vstf/vstf_Tn2.rst new file mode 100644 index 00000000..4b6d0c45 --- /dev/null +++ b/docs/testing/user/vstf/vstf_Tn2.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Tn2 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Tn2 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Tn2 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Tn2. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Tn2.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Tu1.rst b/docs/testing/user/vstf/vstf_Tu1.rst new file mode 100644 index 00000000..cf27bb25 --- /dev/null +++ b/docs/testing/user/vstf/vstf_Tu1.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Tu1 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Tu1 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Tu1 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Tu1. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Tu1.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Tu2.rst b/docs/testing/user/vstf/vstf_Tu2.rst new file mode 100644 index 00000000..2ae84467 --- /dev/null +++ b/docs/testing/user/vstf/vstf_Tu2.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Tu2 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Tu2 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Tu2 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Tu2. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Tu2.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + diff --git a/docs/testing/user/vstf/vstf_Tu3.rst b/docs/testing/user/vstf/vstf_Tu3.rst new file mode 100644 index 00000000..4e090f17 --- /dev/null +++ b/docs/testing/user/vstf/vstf_Tu3.rst @@ -0,0 +1,28 @@ +.. 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. + +******************************************************************* +Bottlenecks vSwitch Test Framework(VSTF) Test Case Description Tu3 +******************************************************************* + + ++-----------------------------------------------------------------------------+ +|Bottlenecks VSTF Tu3 | +| | ++--------------+--------------------------------------------------------------+ +|test case name| opnfv_bottlenecks_vstf_Tu3 | +| | | ++--------------+--------------------------------------------------------------+ +|description | vSwitch test Tu3. | +| | | ++--------------+--------------------------------------------------------------+ +|configuration | config file: | +| | /testsuite/vstf/testcase_cfg/vstf_Tu3.yaml | +| | | ++--------------+--------------------------------------------------------------+ +|test result | throughput & latency | +| | | ++--------------+--------------------------------------------------------------+ + -- cgit 1.2.3-korg