Merge "Add test case description and task file for TC073(netperf)"

2 files changed, 118 insertions, 0 deletions

diff --git a/docs/userguide/opnfv_yardstick_tc073.rst b/docs/userguide/opnfv_yardstick_tc073.rst
new file mode 100644
index 000000000..a6499eabb
--- /dev/null
+++ b/docs/userguide/opnfv_yardstick_tc073.rst
@@ -0,0 +1,81 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
+*************************************
+Yardstick Test Case Description TC073
+*************************************
+
+.. _netperf: http://www.netperf.org/netperf/training/Netperf.html
+
++-----------------------------------------------------------------------------+
+|Throughput per NFVI node test                                                |
+|                                                                             |
++--------------+--------------------------------------------------------------+
+|test case id  | OPNFV_YARDSTICK_TC073_Network latency and throughput between |
+|              | nodes                                                        |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|metric        | Network latency and throughput                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test purpose  | To evaluate the IaaS network performance with regards to     |
+|              | flows and throughput, such as if and how different amounts   |
+|              | of packet sizes and flows matter for the throughput between  |
+|              | nodes in one pod.                                            |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|configuration | file: opnfv_yardstick_tc073.yaml                             |
+|              |                                                              |
+|              | Packet size: default 1024 bytes.                             |
+|              |                                                              |
+|              | Test length: default 20 seconds.                             |
+|              |                                                              |
+|              | The client and server are distributed on different nodes.    |
+|              |                                                              |
+|              | For SLA max_mean_latency is set to 100.                      |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test tool     | netperf                                                      |
+|              | Netperf is a software application that provides network      |
+|              | bandwidth testing between two hosts on a network. It         |
+|              | supports Unix domain sockets, TCP, SCTP, DLPI and UDP via    |
+|              | BSD Sockets. Netperf provides a number of predefined tests   |
+|              | e.g. to measure bulk (unidirectional) data transfer or       |
+|              | request response performance.                                |
+|              | (netperf is not always part of a Linux distribution, hence   |
+|              | it needs to be installed.)                                   |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|references    | netperf Man pages                                            |
+|              | ETSI-NFV-TST001                                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|applicability | Test can be configured with different packet sizes and       |
+|              | test duration. Default values exist.                         |
+|              |                                                              |
+|              | SLA (optional): max_mean_latency                             |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|pre-test      | The POD can be reached by external ip and logged on via ssh  |
+|conditions    |                                                              |
++--------------+--------------------------------------------------------------+
+|test sequence | description and expected result                              |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 1        | Install netperf tool on each specified node, one is as the   |
+|              | server, and the other as the client.                         |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 2        | Log on to the client node and use the netperf command to     |
+|              | execute the network performance test                         |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|step 3        | The throughput results stored.                               |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
+|test verdict  | Fails only if SLA is not passed, or if there is a test case  |
+|              | execution problem.                                           |
+|              |                                                              |
++--------------+--------------------------------------------------------------+
diff --git a/tests/opnfv/test_cases/opnfv_yardstick_tc073.yaml b/tests/opnfv/test_cases/opnfv_yardstick_tc073.yaml
new file mode 100755
index 000000000..fd95b8c9d
--- /dev/null
+++ b/tests/opnfv/test_cases/opnfv_yardstick_tc073.yaml
@@ -0,0 +1,37 @@
+---
+# Yardstick TC073 config file
+# measure network latency and throughput using netperf
+# There are two sample scenarios: bulk test and request/response test
+# In bulk test, UDP_STREAM and TCP_STREAM can be used
+# send_msg_size and recv_msg_size are options of bulk test
+# In req/rsp test, TCP_RR TCP_CRR UDP_RR can be used
+# req_rsp_size is option of req/rsp test
+
+schema: "yardstick:task:0.1"
+{% set host = host or "node1.LF" %}
+{% set target = target or "node2.LF" %}
+{% set pod_info = pod_info or "etc/yardstick/nodes/compass_sclab_physical/pod.yaml" %}
+scenarios:
+-
+  type: NetperfNode
+  options:
+    testname: 'UDP_STREAM'
+    send_msg_size: 1024
+    duration: 20
+
+  host: {{host}}
+  target: {{target}}
+
+  runner:
+    type: Iteration
+    iterations: 1
+    interval: 1
+  sla:
+    mean_latency: 100
+    action: monitor
+
+context:
+  type: Node
+  name: LF
+  file: {{pod_info}}
+