summaryrefslogtreecommitdiffstats
path: root/docs/testing/user/userguide/02-methodology.rst
blob: b1eee9781c561dc9bdae77cf9157b6a3c532471e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
.. This work is licensed under a Creative Commons Attribution 4.0 International
   License.
   http://creativecommons.org/licenses/by/4.0
   (c) OPNFV, Ericsson AB and others.

   Convention for heading levels in Yardstick documentation:

   =======  Heading 0 (reserved for the title in a document)
   -------  Heading 1
   ^^^^^^^  Heading 2
   +++++++  Heading 3
   '''''''  Heading 4

   Avoid deeper levels because they do not render well.

===========
Methodology
===========

Abstract
--------

This chapter describes the methodology implemented by the Yardstick project for
verifying the :term:`NFVI` from the perspective of a :term:`VNF`.

ETSI-NFV
--------

.. _NFV-TST001: http://www.etsi.org/deliver/etsi_gs/NFV-TST/001_099/001/01.01.01_60/gs_NFV-TST001v010101p.pdf
.. _Yardsticktst: https://wiki.opnfv.org/download/attachments/2925202/opnfv_summit_-_bridging_opnfv_and_etsi.pdf?version=1&modificationDate=1458848320000&api=v2


The document ETSI GS NFV-TST001_, "Pre-deployment Testing; Report on Validation
of NFV Environments and Services", recommends methods for pre-deployment
testing of the functional components of an NFV environment.

The Yardstick project implements the methodology described in chapter 6, "Pre-
deployment validation of NFV infrastructure".

The methodology consists in decomposing the typical :term:`VNF` work-load
performance metrics into a number of characteristics/performance vectors, which
each can be represented by distinct test-cases.

The methodology includes five steps:

* *Step1:* Define Infrastruture - the Hardware, Software  and corresponding
   configuration target for validation; the OPNFV infrastructure, in OPNFV
   community labs.

* *Step2:* Identify :term:`VNF` type - the application for which the
   infrastructure is to be validated, and its requirements on the underlying
   infrastructure.

* *Step3:* Select test cases - depending on the workload that represents the
   application for which the infrastruture is to be validated, the relevant
   test cases amongst the list of available Yardstick test cases.

* *Step4:* Execute tests - define the duration and number of iterations for the
   selected test cases, tests runs are automated via OPNFV Jenkins Jobs.

* *Step5:* Collect results - using the common API for result collection.

.. seealso:: Yardsticktst_ for material on alignment ETSI TST001 and Yardstick.

Metrics
-------

The metrics, as defined by ETSI GS NFV-TST001, are shown in
:ref:`Table1 <table2_1>`, :ref:`Table2 <table2_2>` and
:ref:`Table3 <table2_3>`.

In OPNFV Colorado release, generic test cases covering aspects of the listed
metrics are available; further OPNFV releases will provide extended testing of
these metrics.
The view of available Yardstick test cases cross ETSI definitions in
:ref:`Table1 <table2_1>`, :ref:`Table2 <table2_2>` and :ref:`Table3 <table2_3>`
is shown in :ref:`Table4 <table2_4>`.
It shall be noticed that the Yardstick test cases are examples, the test
duration and number of iterations are configurable, as are the System Under
Test (SUT) and the attributes (or, in Yardstick nomemclature, the scenario
options).

.. _table2_1:

**Table 1 - Performance/Speed Metrics**

+---------+-------------------------------------------------------------------+
| Category| Performance/Speed                                                 |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Compute | * Latency for random memory access                                |
|         | * Latency for cache read/write operations                         |
|         | * Processing speed (instructions per second)                      |
|         | * Throughput for random memory access (bytes per second)          |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Network | * Throughput per NFVI node (frames/byte per second)               |
|         | * Throughput provided to a VM (frames/byte per second)            |
|         | * Latency per traffic flow                                        |
|         | * Latency between VMs                                             |
|         | * Latency between NFVI nodes                                      |
|         | * Packet delay variation (jitter) between VMs                     |
|         | * Packet delay variation (jitter) between NFVI nodes              |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Storage | * Sequential read/write IOPS                                      |
|         | * Random read/write IOPS                                          |
|         | * Latency for storage read/write operations                       |
|         | * Throughput for storage read/write operations                    |
|         |                                                                   |
+---------+-------------------------------------------------------------------+

.. _table2_2:

**Table 2 - Capacity/Scale Metrics**

+---------+-------------------------------------------------------------------+
| Category| Capacity/Scale                                                    |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Compute | * Number of cores and threads- Available memory size              |
|         | * Cache size                                                      |
|         | * Processor utilization (max, average, standard deviation)        |
|         | * Memory utilization (max, average, standard deviation)           |
|         | * Cache utilization (max, average, standard deviation)            |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Network | * Number of connections                                           |
|         | * Number of frames sent/received                                  |
|         | * Maximum throughput between VMs (frames/byte per second)         |
|         | * Maximum throughput between NFVI nodes (frames/byte per second)  |
|         | * Network utilization (max, average, standard deviation)          |
|         | * Number of traffic flows                                         |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Storage | * Storage/Disk size                                               |
|         | * Capacity allocation (block-based, object-based)                 |
|         | * Block size                                                      |
|         | * Maximum sequential read/write IOPS                              |
|         | * Maximum random read/write IOPS                                  |
|         | * Disk utilization (max, average, standard deviation)             |
|         |                                                                   |
+---------+-------------------------------------------------------------------+

.. _table2_3:

**Table 3 - Availability/Reliability Metrics**

+---------+-------------------------------------------------------------------+
| Category| Availability/Reliability                                          |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Compute | * Processor availability (Error free processing time)             |
|         | * Memory availability (Error free memory time)                    |
|         | * Processor mean-time-to-failure                                  |
|         | * Memory mean-time-to-failure                                     |
|         | * Number of processing faults per second                          |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Network | * NIC availability (Error free connection time)                   |
|         | * Link availability (Error free transmission time)                |
|         | * NIC mean-time-to-failure                                        |
|         | * Network timeout duration due to link failure                    |
|         | * Frame loss rate                                                 |
|         |                                                                   |
+---------+-------------------------------------------------------------------+
| Storage | * Disk availability (Error free disk access time)                 |
|         | * Disk mean-time-to-failure                                       |
|         | * Number of failed storage read/write operations per second       |
|         |                                                                   |
+---------+-------------------------------------------------------------------+

.. _table2_4:

**Table 4 - Yardstick Generic Test Cases**

+---------+-------------------+----------------+------------------------------+
| Category| Performance/Speed | Capacity/Scale | Availability/Reliability     |
|         |                   |                |                              |
+---------+-------------------+----------------+------------------------------+
| Compute | TC003 [1]_        | TC003 [1]_     |  TC013 [1]_                  |
|         | TC004             | TC004          |  TC015 [1]_                  |
|         | TC010             | TC024          |                              |
|         | TC012             | TC055          |                              |
|         | TC014             |                |                              |
|         | TC069             |                |                              |
+---------+-------------------+----------------+------------------------------+
| Network | TC001             | TC044          |  TC016 [1]_                  |
|         | TC002             | TC073          |  TC018 [1]_                  |
|         | TC009             | TC075          |                              |
|         | TC011             |                |                              |
|         | TC042             |                |                              |
|         | TC043             |                |                              |
+---------+-------------------+----------------+------------------------------+
| Storage | TC005             | TC063          |  TC017 [1]_                  |
+---------+-------------------+----------------+------------------------------+

.. note:: The description in this OPNFV document is intended as a reference for
  users to understand the scope of the Yardstick Project and the
  deliverables of the Yardstick framework. For complete description of
  the methodology, please refer to the ETSI document.

.. rubric:: Footnotes
.. [1] To be included in future deliveries.