[docs] Test case documentation for vEPC testing 63/63963/8
authorAbhijit Sinha <abhijit.sinha@intel.com>
Wed, 24 Oct 2018 17:04:35 +0000 (18:04 +0100)
committerAbhijit Sinha <abhijit.sinha@intel.com>
Wed, 31 Oct 2018 20:09:53 +0000 (20:09 +0000)
JIRA: YARDSTICK-1349

The test case document will cover the following:
- test purpose
- test configuration
- pre-test conditions
- test sequence
- test verdict

Change-Id: I2841a7ff3d248bb3e4739579fad722dc02b5504f
Signed-off-by: Abhijit Sinha <abhijit.sinha@intel.com>
docs/testing/user/userguide/nsb/nsb-list-of-tcs.rst
docs/testing/user/userguide/nsb/tc_epc_dedicated_bearer_landslide.rst [new file with mode: 0644]
docs/testing/user/userguide/nsb/tc_epc_default_bearer_landslide.rst [new file with mode: 0644]
docs/testing/user/userguide/nsb/tc_epc_network_service_request_landslide.rst [new file with mode: 0644]
docs/testing/user/userguide/nsb/tc_epc_saegw_tput_relocation_landslide.rst [new file with mode: 0644]
docs/testing/user/userguide/nsb/tc_epc_ue_service_request_landslide.rst [new file with mode: 0644]

index 8958372..f9ca900 100644 (file)
@@ -28,3 +28,8 @@ NSB PROX Test Case Descriptions
    tc_prox_context_load_balancer_port
    tc_prox_context_vpe_port
    tc_prox_context_lw_after_port
+   tc_epc_default_bearer_landslide
+   tc_epc_dedicated_bearer_landslide
+   tc_epc_saegw_tput_relocation_landslide
+   tc_epc_network_service_request_landslide
+   tc_epc_ue_service_request_landslide
diff --git a/docs/testing/user/userguide/nsb/tc_epc_dedicated_bearer_landslide.rst b/docs/testing/user/userguide/nsb/tc_epc_dedicated_bearer_landslide.rst
new file mode 100644 (file)
index 0000000..c8865ed
--- /dev/null
@@ -0,0 +1,156 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, 2018 Intel Corporation.
+
+*********************************************************
+Yardstick Test Case Description: NSB EPC DEDICATED BEARER
+*********************************************************
+
++-----------------------------------------------------------------------------+
+|NSB EPC dedicated bearer test case                                           |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case id  | tc_epc_{initiator}_dedicated_bearer_landslide                |
+|              |                                                              |
+|              | * initiator: dedicated bearer creation initiator side could  |
+|              |   be UE (ue) or Network (network).                           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|metric        | All metrics provided by Spirent Landslide traffic generator  |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test purpose  | The Spirent Landslide product provides one box solution which|
+|              | allows to fully emulate all EPC network nodes including      |
+|              | mobile users, network host and generate control and data     |
+|              | plane traffic.                                               |
+|              |                                                              |
+|              | This test allows to check processing capability under        |
+|              | different levels of load (number of subscriber, generated    |
+|              | traffic throughput, etc.) for case when default and dedicated|
+|              | bearers are creating and using for traffic transferring.     |
+|              |                                                              |
+|              | It's easy to replace emulated node or multiple nodes in test |
+|              | topology with real node or corresponding vEPC VNF as DUT and |
+|              | check it's processing capabilities under specific test case  |
+|              | load conditions.                                             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|configuration | The EPC dedicated bearer test cases are listed below:        |
+|              |                                                              |
+|              | * tc_epc_ue_dedicated_bearer_create_landslide.yaml           |
+|              | * tc_epc_network_dedicated_bearer_create_landslide.yaml      |
+|              |                                                              |
+|              | Test duration:                                               |
+|              |                                                              |
+|              | * is set as 60sec (specified in test session profile);       |
+|              |                                                              |
+|              | Traffic type:                                                |
+|              |                                                              |
+|              | * UDP;                                                       |
+|              |                                                              |
+|              | Packet sizes:                                                |
+|              |                                                              |
+|              | * 512 bytes;                                                 |
+|              |                                                              |
+|              | Traffic transaction rate:                                    |
+|              |                                                              |
+|              | * 5 trans/s.;                                                |
+|              |                                                              |
+|              | Number of mobile subscribers:                                |
+|              |                                                              |
+|              | * 20000;                                                     |
+|              |                                                              |
+|              | Number of default bearers per subscriber:                    |
+|              |                                                              |
+|              | * 1;                                                         |
+|              |                                                              |
+|              | Number of dedicated bearers per default bearer:              |
+|              |                                                              |
+|              | * 1.                                                         |
+|              |                                                              |
+|              | The above fields and values are the main options used for the|
+|              | test case. Other configurable options could be found in test |
+|              | session profile yaml file. All these options have default    |
+|              | values which can be overwritten in test case file.           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test tool     | Spirent Landslide                                            |
+|              |                                                              |
+|              | The Spirent Landslide is a tool for functional and           |
+|              | performance testing of different types of mobile networks.   |
+|              | It emulates real-world control and data traffic of mobile    |
+|              | subscribers moving through virtualized EPC network.          |
+|              | Detailed description of Spirent Landslide product could be   |
+|              | found here: https://www.spirent.com/Products/Landslide       |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|applicability | This EPC DEDICATED BEARER test cases can be configured with  |
+|              | different:                                                   |
+|              |                                                              |
+|              |  * packet sizes;                                             |
+|              |  * traffic transaction rate;                                 |
+|              |  * number of subscribers sessions;                           |
+|              |  * number of default bearers per subscriber;                 |
+|              |  * number of dedicated bearers per default;                  |
+|              |  * subscribers connection rate;                              |
+|              |  * subscribers disconnection rate;                           |
+|              |  * dedicated bearers activation timeout;                     |
+|              |  * DMF (traffic profile);                                    |
+|              |  * enable/disable Fireball DMF threading model that provides |
+|              |    optimized performance;                                    |
+|              |                                                              |
+|              | Default values exist.                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|references    | ETSI-NFV-TST001                                              |
+|              |                                                              |
+|              | 3GPP TS 32.455                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+| pre-test     | * All Spirent Landslide dependencies need to be installed.   |
+| conditions   |   The steps are described in NSB installation chapter for the|
+|              |   Spirent Landslide vEPC tests;                              |
+|              |                                                              |
+|              | * The pod.yaml file contains all necessary information (TAS  |
+|              |   VM IP address, NICs, emulated SUTs and Test Nodes          |
+|              |   parameters (names, types, ip addresses, etc.).             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test sequence | description and expected result                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 1        | Spirent Landslide components are running on the hosts        |
+|              | specified in the pod file.                                   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 2        | Yardstick is connected with Spirent Landslide Test           |
+|              | Administrator Server (TAS) by TCL and REST API. The test     |
+|              | will resolve the topology and instantiate all emulated EPC   |
+|              | network nodes.                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 3        | Test scenarios run, which performs the following steps:      |
+|              |                                                              |
+|              | * Start the emulated EPC network nodes;                      |
+|              | * Establish the subscribers connections to EPC network       |
+|              |   (default bearers);                                         |
+|              | * Establish the number of dedicated bearers as per per       |
+|              |   default bearer for each subscriber;                        |
+|              | * Create the sessions and transmit traffic through EPC       |
+|              |   network nodes during the specified traffic duration time;  |
+|              | * Disconnect dedicated bearers;                              |
+|              | * Disconnect subscribers at the end of the test.             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 4        | During test run, all the metrics provided by Spirent         |
+|              | Landslide are stored in the yardstick dispatcher.            |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test verdict  | The test case will create the test session in Spirent        |
+|              | Landslide with the test case parameters and store the results|
+|              | in the database for benchmarking purposes. The aim is only   |
+|              | to collect all the metrics that are provided by Spirent      |
+|              | Landslide product for each test specific scenario.           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
diff --git a/docs/testing/user/userguide/nsb/tc_epc_default_bearer_landslide.rst b/docs/testing/user/userguide/nsb/tc_epc_default_bearer_landslide.rst
new file mode 100644 (file)
index 0000000..9e6d778
--- /dev/null
@@ -0,0 +1,149 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, 2018 Intel Corporation.
+
+*******************************************************
+Yardstick Test Case Description: NSB EPC DEFAULT BEARER
+*******************************************************
+
++-----------------------------------------------------------------------------+
+|NSB EPC default bearer test case                                             |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case id  | tc_epc_default_bearer_landslide_{dmf_setup}                  |
+|              |                                                              |
+|              | * dmf_setup: single or multi dmf test session setup;         |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|metric        | All metrics provided by Spirent Landslide traffic generator  |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test purpose  | The Spirent Landslide product provides one box solution which|
+|              | allows to fully emulate all EPC network nodes including      |
+|              | mobile users, network host and generate control and data     |
+|              | plane traffic.                                               |
+|              |                                                              |
+|              | This test allows to check processing capability of EPC under |
+|              | different levels of load (number of subscriber, generated    |
+|              | traffic throughput) for case when only one default bearer is |
+|              | using for transferring traffic from UE to Network.           |
+|              |                                                              |
+|              | It's easy to replace emulated node or multiple nodes in test |
+|              | topology with real node or corresponding vEPC VNF as DUT and |
+|              | check it's processing capabilities under specific test case  |
+|              | load conditions.                                             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|configuration | The EPC default bearer test cases are listed below:          |
+|              |                                                              |
+|              | * tc_epc_default_bearer_create_landslide.yaml                |
+|              | * tc_epc_default_bearer_create_landslide_multi_dmf.yaml      |
+|              |                                                              |
+|              | Test duration:                                               |
+|              |                                                              |
+|              | * is set as 60sec (specified in test session profile);       |
+|              |                                                              |
+|              | Traffic type:                                                |
+|              |                                                              |
+|              | * UDP - for single DMF test case;                            |
+|              | * UDP and TCP - for multi DMF test case;                     |
+|              |                                                              |
+|              | Packet sizes:                                                |
+|              |                                                              |
+|              | * 512 bytes for UDP packets;                                 |
+|              | * 1518 bytes for TCP packets;                                |
+|              |                                                              |
+|              | Traffic transaction rate:                                    |
+|              |                                                              |
+|              | * 5 trans/s.;                                                |
+|              |                                                              |
+|              | Number of mobile subscribers:                                |
+|              |                                                              |
+|              | * 20000;                                                     |
+|              |                                                              |
+|              | Number of default bearers per subscriber:                    |
+|              |                                                              |
+|              | * 1.                                                         |
+|              |                                                              |
+|              | The above fields and values are the main options used for the|
+|              | test case. Other configurable options could be found in test |
+|              | session profile yaml file. All these options have default    |
+|              | values which can be overwritten in test case file.           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test tool     | Spirent Landslide                                            |
+|              |                                                              |
+|              | The Spirent Landslide is a tool for functional & performance |
+|              | testing of different types of mobile networks. It emulates   |
+|              | real-world control and data traffic of mobile subscribers    |
+|              | moving through virtualized EPC network.                      |
+|              | Detailed description of Spirent Landslide product could be   |
+|              | found here: https://www.spirent.com/Products/Landslide       |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|applicability | This EPC DEFAULT BEARER test cases can be configured with    |
+|              | different:                                                   |
+|              |                                                              |
+|              |  * packet sizes;                                             |
+|              |  * traffic transaction rate;                                 |
+|              |  * number of subscribers sessions;                           |
+|              |  * number of default bearers per subscriber;                 |
+|              |  * subscribers connection rate;                              |
+|              |  * subscribers disconnection rate;                           |
+|              |  * DMF (traffic profile);                                    |
+|              |  * enable/disable Fireball DMF threading model that provides |
+|              |    optimized performance;                                    |
+|              |                                                              |
+|              | Default values exist.                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|references    | ETSI-NFV-TST001                                              |
+|              |                                                              |
+|              | 3GPP TS 32.455                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+| pre-test     | * All Spirent Landslide dependencies are installed (detailed |
+| conditions   |   installation steps are described in Chapter 13-            |
+|              |   nsb-installation.rst and 14-nsb-operation.rst file for NSB |
+|              |   Spirent Landslide vEPC tests;                              |
+|              |                                                              |
+|              | * The pod.yaml file contains all necessary information       |
+|              |   (TAS VM IP address, NICs, emulated SUTs and Test Nodes     |
+|              |   parameters (names, types, ip addresses, etc.).             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test sequence | description and expected result                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 1        | Spirent Landslide components are running on the hosts        |
+|              | specified in the pod file.                                   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 2        | Yardstick is connected with Spirent Landslide Test           |
+|              | Administration Server (TAS) by TCL and REST API. The test    |
+|              | will resolve the topology and instantiate all emulated EPC   |
+|              | network nodes.                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 3        | Test scenarios run, which performs the following steps:      |
+|              |                                                              |
+|              | * Start emulated EPC network nodes;                          |
+|              | * Establish subscribers connections to EPC network (only     |
+|              |   default bearers are established);                          |
+|              | * Create the sessions and transmit traffic through EPC       |
+|              |   network nodes during the specified traffic duration time;  |
+|              | * Disconnect subscribers at the end of the test.             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 4        | During test run, all the metrics provided by Spirent         |
+|              | Landslide are stored in the yardstick dispatcher.            |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test verdict  | The test case will create the test session in Spirent        |
+|              | Landslide with the test case parameters and store the        |
+|              | results in the database for benchmarking purposes. The aim   |
+|              | is only to collect all the metrics that are provided by      |
+|              | Spirent Landslide product for each test specific scenario.   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
diff --git a/docs/testing/user/userguide/nsb/tc_epc_network_service_request_landslide.rst b/docs/testing/user/userguide/nsb/tc_epc_network_service_request_landslide.rst
new file mode 100644 (file)
index 0000000..85e6ce1
--- /dev/null
@@ -0,0 +1,159 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, 2018 Intel Corporation.
+
+****************************************************************
+Yardstick Test Case Description: NSB EPC NETWORK SERVICE REQUEST
+****************************************************************
+
++-----------------------------------------------------------------------------+
+|NSB EPC network service request test case                                    |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case id  | tc_epc_network_service_request_landslide                     |
+|              |                                                              |
+|              | * initiator: service request initiator side could be UE (ue) |
+|              |   or Network (network).                                      |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|metric        | All metrics provided by Spirent Landslide traffic generator  |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test purpose  | The Spirent Landslide product provides one box solution which|
+|              | allows to fully emulate all EPC network nodes including      |
+|              | mobile users, network host and generate control and data     |
+|              | plane traffic.                                               |
+|              |                                                              |
+|              | This test covers case of network initiated service request & |
+|              | allows to check processing capabilities of EPC handling high |
+|              | amount of continuous Downlink Data Notification messages from|
+|              | network to UEs which are in Idle state.                      |
+|              |                                                              |
+|              | It's easy to replace emulated node or multiple nodes in test |
+|              | topology with real node or corresponding vEPC VNF as DUT and |
+|              | check it's processing capabilities under specific test case  |
+|              | load conditions.                                             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|configuration | The EPC network service request test cases are listed below: |
+|              |                                                              |
+|              | * tc_epc_network_service_request_landslide.yaml              |
+|              |                                                              |
+|              | Test duration:                                               |
+|              |                                                              |
+|              | * is set as 60sec (specified in test session profile);       |
+|              |                                                              |
+|              | Traffic type:                                                |
+|              |                                                              |
+|              | * UDP;                                                       |
+|              |                                                              |
+|              | Packet sizes:                                                |
+|              |                                                              |
+|              | * 512 bytes;                                                 |
+|              |                                                              |
+|              | Traffic transaction rate:                                    |
+|              |                                                              |
+|              | * 0.1 trans/s.;                                              |
+|              |                                                              |
+|              | Number of mobile subscribers:                                |
+|              |                                                              |
+|              | * 20000;                                                     |
+|              |                                                              |
+|              | Number of default bearers per subscriber:                    |
+|              |                                                              |
+|              | * 1;                                                         |
+|              |                                                              |
+|              | Idle entry time (timeout after which UE goes to Idle state): |
+|              |                                                              |
+|              | * 5s;                                                        |
+|              |                                                              |
+|              | Traffic start delay:                                         |
+|              |                                                              |
+|              | * 1000ms.                                                    |
+|              |                                                              |
+|              | The above fields and values are the main options used for the|
+|              | test case. Other configurable options could be found in test |
+|              | session profile yaml file. All these options have default    |
+|              | values which can be overwritten in test case file.           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test tool     | Spirent Landslide                                            |
+|              |                                                              |
+|              | The Spirent Landslide is a tool for functional & performance |
+|              | testing of different types of mobile networks. It emulates   |
+|              | real-world control and data traffic of mobile subscribers    |
+|              | moving through virtualized EPC network.                      |
+|              | Detailed description of Spirent Landslide product could be   |
+|              | found here: https://www.spirent.com/Products/Landslide       |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|applicability | This EPC NETWORK SERVICE REQUEST test case can be configured |
+|              | with different:                                              |
+|              |                                                              |
+|              |  * packet sizes;                                             |
+|              |  * traffic transaction rate;                                 |
+|              |  * number of subscribers sessions;                           |
+|              |  * number of default bearers per subscriber;                 |
+|              |  * subscribers connection rate;                              |
+|              |  * subscribers disconnection rate;                           |
+|              |  * timeout after which UE goes to Idle state;                |
+|              |  * Traffic start delay;                                      |
+|              |                                                              |
+|              | Default values exist.                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|references    | ETSI-NFV-TST001                                              |
+|              |                                                              |
+|              | 3GPP TS 32.455                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+| pre-test     | * All Spirent Landslide dependencies are installed (detailed |
+| conditions   |   installation steps are described in Chapter 13-            |
+|              |   nsb-installation.rst and 14-nsb-operation.rst file for NSB |
+|              |   Spirent Landslide vEPC tests;                              |
+|              |                                                              |
+|              | * The pod.yaml file contains all necessary information       |
+|              |   (TAS VM IP address, NICs, emulated SUTs and Test Nodes     |
+|              |   parameters (names, types, ip addresses, etc.).             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test sequence | description and expected result                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 1        | Spirent Landslide components are running on the hosts        |
+|              | specified in the pod file.                                   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 2        | Yardstick is connected with Spirent Landslide Test           |
+|              | Administration Server (TAS) by TCL and REST API. The test    |
+|              | will resolve the topology and instantiate all emulated EPC   |
+|              | network nodes.                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 3        | Test scenarios run, which performs the following steps:      |
+|              |                                                              |
+|              | * Start emulated EPC network nodes;                          |
+|              | * Establish subscribers connections to EPC network (default  |
+|              |   bearers);                                                  |
+|              | * Switch UE to Idle state after specified in test case       |
+|              |   timeout;                                                   |
+|              | * Send Downlink Data Notification from network to UE, that   |
+|              |   will return UE to active state. This process is continuous |
+|              |   and during whole test run UEs will be going to Idle state  |
+|              |   and will be switched back to active state after Downlink   |
+|              |   Data Notification was received;                            |
+|              | * Disconnect subscribers at the end of the test.             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 4        | During test run, all the metrics provided by Spirent         |
+|              | Landslide are stored in the yardstick dispatcher.            |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test verdict  | The test case will create the test session in Spirent        |
+|              | Landslide with the test case parameters and store the        |
+|              | results in the database for benchmarking purposes. The aim   |
+|              | is only to collect all the metrics that are provided by      |
+|              | Spirent Landslide product for each test specific scenario.   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
diff --git a/docs/testing/user/userguide/nsb/tc_epc_saegw_tput_relocation_landslide.rst b/docs/testing/user/userguide/nsb/tc_epc_saegw_tput_relocation_landslide.rst
new file mode 100644 (file)
index 0000000..1025175
--- /dev/null
@@ -0,0 +1,167 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, 2018 Intel Corporation.
+
+*********************************************************
+Yardstick Test Case Description: NSB EPC SAEGW RELOCATION
+*********************************************************
+
++-----------------------------------------------------------------------------+
+|NSB EPC SAEGW throughput with relocation test case                           |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case id  | tc_epc_saegw_tput_relocation_landslide                       |
+|              |                                                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|metric        | All metrics provided by Spirent Landslide traffic generator  |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test purpose  | The Spirent Landslide product provides one box solution which|
+|              | allows to fully emulate all EPC network nodes including      |
+|              | mobile users, network host and generate control and data     |
+|              | plane traffic.                                               |
+|              |                                                              |
+|              | This test allows to check processing capability of EPC       |
+|              | handling large amount of subscribers X2 handovers between    |
+|              | different eNBs while UEs are sending traffic.                |
+|              |                                                              |
+|              | It's easy to replace emulated node or multiple nodes in test |
+|              | topology with real node or corresponding vEPC VNF as DUT and |
+|              | check it's processing capabilities under specific test case  |
+|              | load conditions.                                             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|configuration | The EPC SAEGW throughput with relocation tests are listed    |
+|              | below:                                                       |
+|              |                                                              |
+|              | * tc_epc_saegw_tput_relocation_landslide.yaml                |
+|              |                                                              |
+|              | Test duration:                                               |
+|              |                                                              |
+|              | * is set as 60sec (specified in test session profile);       |
+|              |                                                              |
+|              | Traffic type:                                                |
+|              |                                                              |
+|              | * UDP;                                                       |
+|              |                                                              |
+|              | Packet sizes:                                                |
+|              |                                                              |
+|              | * 512 bytes;                                                 |
+|              |                                                              |
+|              | Traffic transaction rate:                                    |
+|              |                                                              |
+|              | * 5 trans/s.;                                                |
+|              |                                                              |
+|              | Number of mobile subscribers:                                |
+|              |                                                              |
+|              | * 20000;                                                     |
+|              |                                                              |
+|              | Number of default bearers per subscriber:                    |
+|              |                                                              |
+|              | * 1;                                                         |
+|              |                                                              |
+|              | Handover type:                                               |
+|              |                                                              |
+|              | * X2 handover;                                               |
+|              |                                                              |
+|              | Mobility time (timeout after sessions were established after |
+|              | which handover will start):                                  |
+|              |                                                              |
+|              | * 10000ms;                                                   |
+|              |                                                              |
+|              | Handover start type:                                         |
+|              |                                                              |
+|              | * When all sessions started;                                 |
+|              |                                                              |
+|              | Mobility mode:                                               |
+|              |                                                              |
+|              | * Single handoff;                                            |
+|              |                                                              |
+|              | Mobility Rate:                                               |
+|              |                                                              |
+|              | * 120 subscribers/s.                                         |
+|              |                                                              |
+|              | The above fields and values are the main options used for the|
+|              | test case. Other configurable options could be found in test |
+|              | session profile yaml file. All these options have default    |
+|              | values which can be overwritten in test case file.           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test tool     | Spirent Landslide                                            |
+|              |                                                              |
+|              | The Spirent Landslide is a tool for functional & performance |
+|              | testing of different types of mobile networks. It emulates   |
+|              | real-world control and data traffic of mobile subscribers    |
+|              | moving through virtualized EPC network.                      |
+|              | Detailed description of Spirent Landslide product could be   |
+|              | found here: https://www.spirent.com/Products/Landslide       |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|applicability | This EPC UE SERVICE REQUEST test cases can be configured with|
+|              | different:                                                   |
+|              |                                                              |
+|              |  * packet sizes;                                             |
+|              |  * traffic transaction rate;                                 |
+|              |  * number of subscribers sessions;                           |
+|              |  * handover type;                                            |
+|              |  * mobility rate;                                            |
+|              |  * mobility time;                                            |
+|              |  * mobility mode;                                            |
+|              |  * handover start condition;                                 |
+|              |  * subscribers disconnection rate;                           |
+|              |                                                              |
+|              | Default values exist.                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|references    | ETSI-NFV-TST001                                              |
+|              |                                                              |
+|              | 3GPP TS 32.455                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+| pre-test     | * All Spirent Landslide dependencies are installed (detailed |
+| conditions   |   installation steps are described in Chapter 13-            |
+|              |   nsb-installation.rst and 14-nsb-operation.rst file for NSB |
+|              |   Spirent Landslide vEPC tests;                              |
+|              |                                                              |
+|              | * The pod.yaml file contains all necessary information       |
+|              |   (TAS VM IP address, NICs, emulated SUTs and Test Nodes     |
+|              |   parameters (names, types, ip addresses, etc.).             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test sequence | description and expected result                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 1        | Spirent Landslide components are running on the hosts        |
+|              | specified in the pod file.                                   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 2        | Yardstick is connected with Spirent Landslide Test           |
+|              | Administration Server (TAS) by TCL and REST API. The test    |
+|              | will resolve the topology and instantiate all emulated EPC   |
+|              | network nodes.                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 3        | Test scenarios run, which performs the following steps:      |
+|              |                                                              |
+|              | * Start emulated EPC network nodes;                          |
+|              | * Establish subscribers connections to EPC network (default  |
+|              |   bearers);                                                  |
+|              | * Start run traffic;                                         |
+|              | * After specified in test case mobility timeout, start       |
+|              |   handover process on specified mobility rate;               |
+|              | * Disconnect subscribers at the end of the test.             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 4        | During test run, all the metrics provided by Spirent         |
+|              | Landslide are stored in the yardstick dispatcher.            |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test verdict  | The test case will create the test session in Spirent        |
+|              | Landslide with the test case parameters and store the        |
+|              | results in the database for benchmarking purposes. The aim   |
+|              | is only to collect all the metrics that are provided by      |
+|              | Spirent Landslide product for each test specific scenario.   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
diff --git a/docs/testing/user/userguide/nsb/tc_epc_ue_service_request_landslide.rst b/docs/testing/user/userguide/nsb/tc_epc_ue_service_request_landslide.rst
new file mode 100644 (file)
index 0000000..0711a0c
--- /dev/null
@@ -0,0 +1,174 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, 2018 Intel Corporation.
+
+***********************************************************
+Yardstick Test Case Description: NSB EPC UE SERVICE REQUEST
+***********************************************************
+
++-----------------------------------------------------------------------------+
+|NSB EPC UE service request test case                                         |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case id  | tc_epc_{initiator}_service_request_landslide                 |
+|              |                                                              |
+|              | * initiator: service request initiator side could be UE (ue) |
+|              |   or Network (nw).                                           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|metric        | All metrics provided by Spirent Landslide traffic generator  |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test purpose  | The Spirent Landslide product provides one box solution which|
+|              | allows to fully emulate all EPC network nodes including      |
+|              | mobile users, network host and generate control and data     |
+|              | plane traffic.                                               |
+|              |                                                              |
+|              | This test allows to check processing capabilities of EPC     |
+|              | under high user connections rate and traffic load for case   |
+|              | when UEs initiates service request (UE initiates bearer      |
+|              | modification request to provide dedicated bearer for new     |
+|              | type of traffic)                                             |
+|              |                                                              |
+|              | It's easy to replace emulated node or multiple nodes in test |
+|              | topology with real node or corresponding vEPC VNF as DUT and |
+|              | check it's processing capabilities under specific test case  |
+|              | load conditions.                                             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|configuration | The EPC ue service request test cases are listed below:      |
+|              |                                                              |
+|              | * tc_epc_ue_service_request_landslide.yaml                   |
+|              |                                                              |
+|              | Test duration:                                               |
+|              |                                                              |
+|              | * is set as 60sec (specified in test session profile);       |
+|              |                                                              |
+|              | Traffic type:                                                |
+|              |                                                              |
+|              | * UDP;                                                       |
+|              |                                                              |
+|              | Packet sizes:                                                |
+|              |                                                              |
+|              | * 512 bytes;                                                 |
+|              |                                                              |
+|              | Traffic transaction rate:                                    |
+|              |                                                              |
+|              | * 5 trans/s.;                                                |
+|              |                                                              |
+|              | Number of mobile subscribers:                                |
+|              |                                                              |
+|              | * 20000;                                                     |
+|              |                                                              |
+|              | Number of default bearers per subscriber:                    |
+|              |                                                              |
+|              | * 1;                                                         |
+|              |                                                              |
+|              | Number of dedicated bearers per default bearer:              |
+|              |                                                              |
+|              | * 1.                                                         |
+|              |                                                              |
+|              | TFT settings for dedicated bearers:                          |
+|              |                                                              |
+|              | * TFT configured to filter TCP traffic (Protocol ID 6)       |
+|              |                                                              |
+|              | Modified TFT settings:                                       |
+|              |                                                              |
+|              | * Create new TFT to filter UDP traffic (Protocol ID 17) from |
+|              |   2002 local port and 2003 remote port;                      |
+|              |                                                              |
+|              | Modified QoS settings:                                       |
+|              |                                                              |
+|              | * Set QCI 5 for dedicated bearers;                           |
+|              |                                                              |
+|              | The above fields and values are the main options used for the|
+|              | test case. Other configurable options could be found in test |
+|              | session profile yaml file. All these options have default    |
+|              | values which can be overwritten in test case file.           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test tool     | Spirent Landslide                                            |
+|              |                                                              |
+|              | The Spirent Landslide is a tool for functional & performance |
+|              | testing of different types of mobile networks. It emulates   |
+|              | real-world control and data traffic of mobile subscribers    |
+|              | moving through virtualized EPC network.                      |
+|              | Detailed description of Spirent Landslide product could be   |
+|              | found here: https://www.spirent.com/Products/Landslide       |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|applicability | This EPC UE SERVICE REQUEST test case can be configured with |
+|              | different:                                                   |
+|              |                                                              |
+|              |  * packet sizes;                                             |
+|              |  * traffic transaction rate;                                 |
+|              |  * number of subscribers sessions;                           |
+|              |  * number of default bearers per subscriber;                 |
+|              |  * number of dedicated bearers per default;                  |
+|              |  * subscribers connection rate;                              |
+|              |  * subscribers disconnection rate;                           |
+|              |  * dedicated bearers activation timeout;                     |
+|              |  * DMF (traffic profile);                                    |
+|              |  * enable/disable Fireball DMF threading model that provides |
+|              |    optimized performance;                                    |
+|              |  * Starting TFT settings for dedicated bearers;              |
+|              |  * Modified TFT settings for dedicated bearers;              |
+|              |  * Modified QoS settings for dedicated bearers;              |
+|              |                                                              |
+|              | Default values exist.                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|references    | ETSI-NFV-TST001                                              |
+|              |                                                              |
+|              | 3GPP TS 32.455                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+| pre-test     | * All Spirent Landslide dependencies are installed (detailed |
+| conditions   |   installation steps are described in Chapter 13-            |
+|              |   nsb-installation.rst and 14-nsb-operation.rst file for NSB |
+|              |   Spirent Landslide vEPC tests;                              |
+|              |                                                              |
+|              | * The pod.yaml file contains all necessary information       |
+|              |   (TAS VM IP address, NICs, emulated SUTs and Test Nodes     |
+|              |   parameters (names, types, ip addresses, etc.).             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test sequence | description and expected result                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 1        | Spirent Landslide components are running on the hosts        |
+|              | specified in the pod file.                                   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 2        | Yardstick is connected with Spirent Landslide Test           |
+|              | Administration Server (TAS) by TCL and REST API. The test    |
+|              | will resolve the topology and instantiate all emulated EPC   |
+|              | network nodes.                                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 3        | Test scenarios run, which performs the following steps:      |
+|              |                                                              |
+|              | * Start emulated EPC network nodes;                          |
+|              | * Establish subscribers connections to EPC network (default  |
+|              |   bearers);                                                  |
+|              | * Establish the number of dedicated bearer as specified in   |
+|              |   the test case as per default bearer for each subscriber;   |
+|              | * start run users traffic through EPC network nodes;         |
+|              | * During traffic is running, send bearer modification request|
+|              |   after specified in test case timeout;                      |
+|              | * Disconnect dedicated bearers;                              |
+|              | * Disconnect subscribers at the end of the test.             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 4        | During test run, all the metrics provided by Spirent         |
+|              | Landslide are stored in the yardstick dispatcher.            |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test verdict  | The test case will create the test session in Spirent        |
+|              | Landslide with the test case parameters and store the        |
+|              | results in the database for benchmarking purposes. The aim   |
+|              | is only to collect all the metrics that are provided by      |
+|              | Spirent Landslide product for each test specific scenario.   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+