Update README in fuel plugin
[yardstick.git] / docs / userguide / opnfv_yardstick_tc024.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International
2 .. License.
3 .. http://creativecommons.org/licenses/by/4.0
4 .. (c) OPNFV, Ericsson AB and others.
5
6 *************************************
7 Yardstick Test Case Description TC024
8 *************************************
9
10 .. _man-pages: http://manpages.ubuntu.com/manpages/trusty/man1/mpstat.1.html
11
12 +-----------------------------------------------------------------------------+
13 | CPU Load                                                                    |
14 |                                                                             |
15 +--------------+--------------------------------------------------------------+
16 |test case id  | OPNFV_YARDSTICK_TC024_CPU Load                               |
17 |              |                                                              |
18 +--------------+--------------------------------------------------------------+
19 |metric        | CPU load                                                     |
20 |              |                                                              |
21 +--------------+--------------------------------------------------------------+
22 |test purpose  | To evaluate the CPU load performance of the IaaS. This test  |
23 |              | case should be run in parallel to other Yardstick test cases |
24 |              | and not run as a stand-alone test case.                      |
25 |              |                                                              |
26 |              | The purpose is also to be able to spot trends. Test results, |
27 |              | graphs ans similar shall be stored for comparison reasons and|
28 |              | product evolution understanding between different OPNFV      |
29 |              | versions and/or configurations.                              |
30 |              |                                                              |
31 +--------------+--------------------------------------------------------------+
32 |configuration | file: cpuload.yaml (in the 'samples' directory)              |
33 |              |                                                              |
34 |              | There is are no additional configurations to be set for this |
35 |              | TC.                                                          |
36 |              |                                                              |
37 +--------------+--------------------------------------------------------------+
38 |test tool     | mpstat                                                       |
39 |              |                                                              |
40 |              | (mpstat is not always part of a Linux distribution, hence it |
41 |              | needs to be installed. It is part of the Yardstick Glance    |
42 |              | image. However, if mpstat is not present the TC instead uses |
43 |              | /proc/stats as source to produce "mpstat" output.            |
44 |              |                                                              |
45 +--------------+--------------------------------------------------------------+
46 |references    | man-pages_                                                   |
47 |              |                                                              |
48 +--------------+--------------------------------------------------------------+
49 |applicability | Run in background with other test cases.                     |
50 |              |                                                              |
51 +--------------+--------------------------------------------------------------+
52 |pre-test      | The test case image needs to be installed into Glance        |
53 |conditions    | with mpstat included in it.                                  |
54 |              |                                                              |
55 |              | No POD specific requirements have been identified.           |
56 |              |                                                              |
57 +--------------+--------------------------------------------------------------+
58 |test sequence | description and expected result                              |
59 |              |                                                              |
60 +--------------+--------------------------------------------------------------+
61 |step 1        | The host is installed. The related TC, or TCs, is            |
62 |              | invoked and mpstat logs are produced and stored.             |
63 |              |                                                              |
64 |              | Result: Stored logs                                          |
65 |              |                                                              |
66 +--------------+--------------------------------------------------------------+
67 |test verdict  | None. CPU load results are fetched and stored.               |
68 |              |                                                              |
69 +--------------+--------------------------------------------------------------+