Add test case description and task file for TC010

Add test case description for Memory Latency (TC010) and test case
.yaml task file.

JIRA: YARDSTICK-94

Change-Id: If7fb120868c9901fe097f310aa249e1fbc8a94ee
Signed-off-by: Kristian Hunt <kristian.hunt@gmail.com>

2 files changed, 103 insertions, 0 deletions

diff --git a/docs/yardstick/opnfv_yardstick_tc010.rst b/docs/yardstick/opnfv_yardstick_tc010.rst
new file mode 100644
index 000000000..c2f8eb4e2
--- /dev/null
+++ b/docs/yardstick/opnfv_yardstick_tc010.rst
@@ -0,0 +1,65 @@
+
+*************************************
+Yardstick Test Case Description TC010
+*************************************
++-----------------------------------------------------------------------------+
+|Memory Latency                                                               |
++==============+==============================================================+
+|test case id  | OPNFV_YARDSTICK_TC010_Memory Latency                         |
++--------------+--------------------------------------------------------------+
+|metric        | Latency in nanoseconds                                       |
++--------------+--------------------------------------------------------------+
+|test purpose  | Measure the memory read latency for varying memory sizes and |
+|              | strides. Whole memory hierarchy is measured including all    |
+|              | levels of cache.                                             |
++--------------+--------------------------------------------------------------+
+|configuration | File: opnfv_yardstick_tc010.yaml                             |
+|              |                                                              |
+|              | * SLA (max_latency): 30 nanoseconds                          |
+|              | * Stride - 128 bytes                                         |
+|              | * Stop size - 64 megabytes                                   |
+|              | * Iterations: 10 - test is run 10 times iteratively.         |
+|              | * Interval: 1 - there is 1 second delay between each         |
+|              |   iteration.                                                 |
++--------------+--------------------------------------------------------------+
+|test tool     | Lmbench                                                      |
+|              |                                                              |
+|              | Lmbench is a suite of operating system microbenchmarks. This |
+|              | test uses lat_mem_rd tool from that suite.                   |
+|              | Lmbench is not always part of a Linux distribution, hence it |
+|              | needs to be installed in the test image                      |
+|              | (See :ref:`guest-image` for how to generate a Linux image    |
+|              | for Glance with Lmbench included).                           |
++--------------+--------------------------------------------------------------+
+|references    |* http://manpages.ubuntu.com/manpages/trusty/lat_mem_rd.8.html|
+|              |                                                              |
+|              |* McVoy, Larry W., and Carl Staelin. "lmbench: Portable Tools |
+|              |  for Performance Analysis." *USENIX annual technical         |
+|              |  conference*. 1996.                                          |
++--------------+--------------------------------------------------------------+
+|applicability | Test can be configured with different                        |
+|              |   * strides;                                                 |
+|              |   * stop_size;                                               |
+|              |   * iterations and intervals;                                |
+|              |                                                              |
+|              | There are default values for each above-mentioned option.    |
+|              |                                                              |
+|              |   * SLA (optional).                                          |
+|              |         max_latency: The maximum memory latency that is      |
+|              |         accepted.                                            |
++--------------+--------------------------------------------------------------+
+|pre-test      | The test case image needs to be installed into Glance        |
+|conditions    | with Lmbench included in the image.                          |
+|              |                                                              |
+|              | No POD specific requirements have been identified.           |
++--------------+------+----------------------------------+--------------------+
+|test sequence | step | description                      | result             |
+|              +------+----------------------------------+--------------------+
+|              |  1   | The host is installed as client. | Logs are stored    |
+|              |      | Lmbench's lat_mem_rd tool is     |                    |
+|              |      | invoked and logs are produced and|                    |
+|              |      | stored.                          |                    |
++--------------+------+----------------------------------+--------------------+
+|test verdict  | Test fails if the measured memory latency is above the SLA   |
+|              | value or if there is a test case execution problem.          |
++--------------+--------------------------------------------------------------+
diff --git a/tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml b/tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml
new file mode 100644
index 000000000..42327f05f
--- /dev/null
+++ b/tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml
@@ -0,0 +1,38 @@
+---
+# Yardstick TC010 config file
+# measure memory read latency using lmbench
+
+schema: "yardstick:task:0.1"
+
+scenarios:
+-
+  type: Lmbench
+  options:
+    test_type: "latency"
+    stride: 128
+    stop_size: 64.0
+
+  host: demeter.yardstick-TC010
+
+  runner:
+    type: Iteration
+    iterations: 10
+    interval: 1
+
+  sla:
+    max_latency: 30
+    action: monitor
+
+context:
+  name: yardstick-TC010
+  image: yardstick-trusty-server
+  flavor: m1.small
+  user: ec2-user
+
+  servers:
+    demeter:
+      floating_ip: true
+
+  networks:
+    test:
+      cidr: '10.0.1.0/24'