summaryrefslogtreecommitdiffstats
path: root/docs/release/release-notes/index.rst
blob: 2de92c55577d421db568c07b2dabd8214e066fb3 (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
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. SPDX-License-Identifier: CC-BY-4.0

.. _dovetail-releasenotes:

======================================================================
OPNFV Verification Program (OVP) 2019.12 / Dovetail 3.0.0 Release Note
======================================================================


OPNFV 2019.12 Release
=====================

The OPNFV Verification Program (OVP) allows vendors and operators to obtain 'OPNFV Verified'
status based on an agreed upon set of compliance verification test cases that align to OPNFV
releases. The reference System under Test (SUT) is either the NFV components deployed by the OPNFV
installers for a given release, where OVP 2019.12 is based on the OPNFV Hunter release, or a VNF
being on-boarded and orchestrated by the ONAP El Alto release. Participants of the program can
verify commercial or open source offerings against an OVP release. This implies that the SUT
used for verification has interfaces, components, functions and behaviors that align to OPNFV
installer integrations and ONAP deployments.

Dovetail is the overall framework used to execute tests and collect results for the OVP
Infrastructure badge. Dovetail does not deliver test content directly. Rather, test content
is developed in other OPNFV test frameworks such as Functest and upstream test communities such
as OpenStack's RefStack/Tempest projects. Dovetail leverages this upstream test content and
provides a common set of test platform services for the OVP.

Approved test tools (OPNFV Dovetail, ONAP VTP, and ONAP VVP)  work in conjunction with a web portal
interface dubbed the 'OVP web portal' to allow users to upload test results to a centralized community
repository. This facilitates user collaboration, result sharing, self-testing and community reviews.
It also serves as a hub for new participants to learn about the program and access key resources. The
link for this portal is at: `OPNFV Verification Program <https://nfvi-verified.lfnetworking.org>`_.

Use of the OVP web portal is open to all and only requires a valid Linux Foundation
ID to login. Users are welcome to use the portal to upload, inspect and share results in a private
manner. In order to submit results for official review, the first step is apply for acceptance
into the program with the participation form provided in the link: `OPNFV Verification Program
Participation Form <https://na3.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=dc24bf38-ea41-40d4-9e58-9babc6eec778>`_

NFVI Test Suites and Test Areas
-------------------------------

OVP/Dovetail groups test cases into test suites and test areas. Test suites are currently a basic
categorization around releases for the most part. Executing the test suite 'ovp.2019.12' without
further specification will run all the test cases in the OVP 2019.12 release. Test suites are
divided into test areas that can be executed separately.

Test cases include a division into **'mandatory'** and **'optional'** in an overarching
categorization.

All the mandatory test cases are required to be executed with passing results for all inclusive
test cases for results to be reviewed and approved by the community made up of peer reviewers.
The optional test cases are not required to be executed for the official compliance verification
review in the OVP 2019.12 release. However, execution of these cases is encouraged, as some
optional test cases may become mandatory in future releases.

NFVI Test Cases and Sub Test Cases
----------------------------------

Each test area consists of multiple test cases where each test case can be a single test or
broken down into sub test cases. A listing of test cases with the number of sub test cases noted
in parenthesis is shown below for the OVP 2019.12 release.

**Mandatory**

- bottlenecks.stress.ping (1)
- functest.vping.userdata (1)
- functest.vping.ssh (1)
- functest.tempest.osinterop (219)
- functest.tempest.compute (12)
- functest.tempest.identity_v3 (11)
- functest.tempest.image (2)
- functest.tempest.network_api (14)
- functest.tempest.volume (2)
- functest.tempest.neutron_trunk_ports (38)
- functest.tempest.ipv6_api (21)
- functest.security.patrole (124)
- yardstick.ha.nova_api (1)
- yardstick.ha.neutron_server (1)
- yardstick.ha.keystone (1)
- yardstick.ha.glance_api (1)
- yardstick.ha.cinder_api (1)
- yardstick.ha.cpu_load (1)
- yardstick.ha.disk_load (1)
- yardstick.ha.haproxy (1)
- yardstick.ha.rabbitmq (1)
- yardstick.ha.database  (1)


There are a total of 456 mandatory test cases.

**Optional**

- functest.vnf.vims (1)
- functest.vnf.vepc (1)
- functest.tempest.ipv6_scenario (8)
- functest.tempest.multi_node_scheduling (6)
- functest.tempest.network_security (6)
- functest.tempest.vm_lifecycle (12)
- functest.tempest.network_scenario (5)
- functest.tempest.bgpvpn (21)
- functest.security.patrole_vxlan_dependent (2)
- yardstick.ha.neutron_l3_agent  (1)
- yardstick.ha.controller_restart (1)

There are a total of 64 optional test cases.

OPNFV Test Projects and Components
----------------------------------

The OPNFV test frameworks integrated into the Dovetail framework that deliver test content are:

 - Functest (leverages OpenStack RefStack/Tempest projects in addition to supplying native test cases)
 - Yardstick
 - Bottlenecks

ONAP Test Projects and Components
---------------------------------

The ONAP test projects and components used with this OVP release to provide the test requirements
and test scripting are:

- VNFRQTS
- VNFSDK
- VVP

Acceptence and Marketing
------------------------

Upon successful community review of results for OVP 2019.12, the Linux Foundation Compliance
Verification Committee (LFN CVC) on behalf of the Board of Directors can award a product 'OPNFV
Verified' status. Use of 'OPNFV Verified' Program Marks shall be awarded to the platform used
for compliance verification. The category label of 'Infrastructure' is used within the Program
Marks logo and limits the scope of this OVP release to a SUT consisting of NFVI and VIM components
using ETSI terminology. It does not provide compliance verification for specific VNFs in any fashion.
The date '2019.12' corresponds to a reference SUT that aligns to the OPNFV Hunter release and
currently aligns to the Dovetail framework version 3.0.0.

Organizations shall not use the Program Marks in any way that would associate it with any
individual or company logo or brand, beyond the association to the specific platform to which it
was awarded. While OpenStack RefStack interoperability and Tempest integration test cases are
executed as part of the OVP 2019.12 compliance verification test suites, the OVP does not grant or
award OpenStack Marks in any fashion. 'OPNFV Verified' status does not assert readiness for
commercial deployment.

Please refer to the program governance guidelines and term & conditions documents for additional
details using the respective links:

* `OVP Governance Guidelines <https://www.opnfv.org/wp-content/uploads/sites/12/2018/01/OVP-Governance-Guidelines-1.0.1-012218.pdf>`_
* `OVP Terms and Conditions <https://www.opnfv.org/wp-content/uploads/sites/12/2018/01/OVP-Terms-and-Conditions-011918.pdf>`_

Release Data
============

+--------------------------------------+---------------------------------------+
| **Project**                          | Dovetail                              |
|                                      |                                       |
+--------------------------------------+---------------------------------------+
| **Repo tag**                         | ovp-3.0.1                             |
|                                      |                                       |
+--------------------------------------+---------------------------------------+
| **Release designation**              | OPNFV Verification Program (OVP)      |
|                                      | 2019.12 (Hunter)                      |
+--------------------------------------+---------------------------------------+
| **Release date**                     | December 2019                         |
|                                      |                                       |
+--------------------------------------+---------------------------------------+
| **Purpose of the delivery**          | Support OVP 2019.12 release with      |
|                                      | OPNFV Hunter release as reference SUT |
+--------------------------------------+---------------------------------------+
| **Notes**                            | Point release ovp-3.0.1 updates,      |
|                                      | changes, and corrects the             |
|                                      | documentation only.                   |
+--------------------------------------+---------------------------------------+


Deliverables
============

Software
--------

OPNFV Software
""""""""""""""

+-------------------------+-----------------------------------+----------------+
|  **Docker Container**   | **Docker Image**                  | **Tag**        |
+-------------------------+-----------------------------------+----------------+
|   dovetail              |    opnfv/dovetail                 |    ovp-3.0.0   |
+-------------------------+-----------------------------------+----------------+
|   functest              |    opnfv/functest-smoke           |    hunter      |
+-------------------------+-----------------------------------+----------------+
|   functest              |    opnfv/functest-healthcheck     |    hunter      |
+-------------------------+-----------------------------------+----------------+
|   functest              |    opnfv/functest-vnf             |    hunter      |
+-------------------------+-----------------------------------+----------------+
|   yardstick             |    opnfv/yardstick                |   opnfv-8.0.0  |
+-------------------------+-----------------------------------+----------------+
|   bottlenecks           |    opnfv/bottlenecks              |   8.0.1-latest |
+-------------------------+-----------------------------------+----------------+

**Docker images:**

- `Dovetail Docker images <https://hub.docker.com/r/opnfv/dovetail>`_
- `Functest-smoke Docker images <https://hub.docker.com/r/opnfv/functest-smoke/>`_
- `Functest-healthcheck  Docker images <https://hub.docker.com/r/opnfv/functest-healthcheck/>`_
- `Functest-vnf Docker images <https://hub.docker.com/r/opnfv/functest-vnf/>`_
- `Yardstick Docker images <https://hub.docker.com/r/opnfv/yardstick/>`_
- `Bottlenecks Docker images <https://hub.docker.com/r/opnfv/bottlenecks/>`_

ONAP Software
"""""""""""""

+-------------------------+--------------------------------------------------------------+
| **Item**                |  **Repo Link**                                               |
+-------------------------+--------------------------------------------------------------+
| VTP/VNFSDK Test Scripts | `<https://gerrit.onap.org/r/admin/repos/vnfsdk/refrepo>`_    |
+-------------------------+--------------------------------------------------------------+
| VVP Robot Test Scripts  | `<https://gerrit.onap.org/r/admin/repos/oom>`_               |
+-------------------------+--------------------------------------------------------------+

Documents
---------

- `System Preparation Guide <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/systempreparation/index.html>`_

- `NFVI User Guide <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/userguide/testing_guide.html>`_

- `VNF User Guide: <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/userguide/testing_guide.html>`_

- `OVP NFVI Test Specifications <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/testspecification/index.html>`_

- `ONAP VNF Test Specifications <https://docs.onap.org/en/elalto/submodules/vnfrqts/testcases.git/docs/index.html>`_

- `Dovetail CLI Reference <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/userguide/cli_reference.html>`_

- `Dovetail RESTful API <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/userguide/api_testing_guide.html>`_

- `OVP Workflow <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/certificationworkflow/index.html>`_

- `OVP Reviewer Guide <https://opnfv-dovetail.readthedocs.io/en/stable-hunter/testing/user/reviewerguide/index.html>`_


Testing with OPNFV Hunter Installers
====================================

OVP 2019.12 and Dovetail 3.0.0 are known to be have been tested with the following OPNFV
Hunter installer versions.

+-----------------+----------------------+
|   Installer     |      Version         |
+=================+======================+
|   Fuel          |      stable/hunter   |
+-----------------+----------------------+


Hunter Known Restrictions/Issues
================================

Please refer to the OPNFV and ONAP JIRA for known issues with each applicable project:

- `<https://jira.opnfv.org/projects/DOVETAIL>`_
- `<https://jira.onap.org/projects/VVP>`_
- `<https://jira.onap.org/projects/VNFSDK>`_


Useful Links
============

 - `OVP Web Portal <https://nfvi-verified.lfnetworking.org>`_

 - `Wiki Project Page <https://wiki.opnfv.org/display/dovetail>`_

 - `Dovetail Repo <https://git.opnfv.org/dovetail/>`_

 - `Dovetail CI dashboard <https://build.opnfv.org/ci/view/dovetail/>`_

 - `JIRA dashboard <https://jira.opnfv.org/secure/RapidBoard.jspa?rapidView=149>`_

 - Dovetail IRC Channel: #opnfv-dovetail

 - `Dovetail Test Configuration <https://git.opnfv.org/dovetail/tree/etc/compliance/ovp.2019.12.yaml>`_