1 .. This work is licensed under a Creative Commons Attribution 4.0 International
3 .. http://creativecommons.org/licenses/by/4.0
4 .. (c) OPNFV, Ericsson AB and others.
6 *************************************
7 Yardstick Test Case Description TC010
8 *************************************
10 .. _man-pages: http://manpages.ubuntu.com/manpages/trusty/lat_mem_rd.8.html
12 +-----------------------------------------------------------------------------+
15 +--------------+--------------------------------------------------------------+
16 |test case id | OPNFV_YARDSTICK_TC010_Memory Latency |
18 +--------------+--------------------------------------------------------------+
19 |metric | Latency in nanoseconds |
21 +--------------+--------------------------------------------------------------+
22 |test purpose | Measure the memory read latency for varying memory sizes and |
23 | | strides. Whole memory hierarchy is measured including all |
24 | | levels of cache. |
26 +--------------+--------------------------------------------------------------+
27 |configuration | File: opnfv_yardstick_tc010.yaml |
29 | | * SLA (max_latency): 30 nanoseconds |
30 | | * Stride - 128 bytes |
31 | | * Stop size - 64 megabytes |
32 | | * Iterations: 10 - test is run 10 times iteratively. |
33 | | * Interval: 1 - there is 1 second delay between each |
36 +--------------+--------------------------------------------------------------+
37 |test tool | Lmbench |
39 | | Lmbench is a suite of operating system microbenchmarks. This |
40 | | test uses lat_mem_rd tool from that suite. |
41 | | Lmbench is not always part of a Linux distribution, hence it |
42 | | needs to be installed in the test image |
44 +--------------+--------------------------------------------------------------+
45 |references | man-pages_ |
47 | | McVoy, Larry W.,and Carl Staelin. "lmbench: Portable Tools |
48 | | for Performance Analysis." USENIX annual technical |
49 | | conference 1996. |
51 +--------------+--------------------------------------------------------------+
52 |applicability | Test can be configured with different: |
56 | | * iterations and intervals. |
58 | | There are default values for each above-mentioned option. |
60 | | SLA (optional) : max_latency: The maximum memory latency |
61 | | that is accepted. |
63 +--------------+--------------------------------------------------------------+
64 |pre-test | The test case image needs to be installed into Glance |
65 |conditions | with Lmbench included in the image. |
67 | | No POD specific requirements have been identified. |
69 +--------------+--------------------------------------------------------------+
70 |test sequence | description and expected result |
72 +--------------+--------------------------------------------------------------+
73 |step 1 | The host is installed as client. Lmbench's lat_mem_rd tool |
74 | | is invoked and logs are produced and stored. |
76 | | Result: logs are stored. |
78 +--------------+--------------------------------------------------------------+
79 |test verdict | Test fails if the measured memory latency is above the SLA |
80 | | value or if there is a test case execution problem. |
82 +--------------+--------------------------------------------------------------+