summaryrefslogtreecommitdiffstats
path: root/docs/release/release-notes/dovetail-release.rst
blob: 7940c977fea31c934dc513537d3f52468cbf1014 (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
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. SPDX-License-Identifier: CC-BY-4.0

=======
License
=======

OPNFV Fraser release note for Dovetail Docs
are licensed under a Creative Commons Attribution 4.0 International License.
You should have received a copy of the license along with this.
If not, see http://creativecommons.org/licenses/by/4.0/.

==================================================================
OPNFV Verified Program (OVP) 2018.08 / Dovetail 2.0.0 Release Note
==================================================================

Abstract
========

This document describes the release note of the OPNFV Verified Program and the Dovetail project.


Version History
===============

+------------+----------+--------------------------+
| **Date**   | **Ver.** | **Comment**              |
|            |          |                          |
+------------+----------+--------------------------+
| 2018-01-21 | 1.0.0    | Dovetail for OVP 2018.01 |
|            |          | Danube release           |
+------------+----------+--------------------------+
| 2018-08-09 | 2.0.0    | Dovetail for OVP 2018.08 |
|            |          | Fraser release           |
+------------+----------+--------------------------+


OPNFV 2018.08 Release
=====================

The OPNFV Verified 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) are the NFV components deployed by the OPNFV
installers for a given release, where OVP 2018.08 is based on the Fraser 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.

Dovetail is the overall framework used to execute tests and collect results for OVP. 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.

Dovetail works 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 Verified Program <https://verified.opnfv.org>`_.

Use of the OVP web portal is open to all and only requires a valid Linux Foundation or OpenStack
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 Verified Program
Participation Form <https://na3.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=579ac00d-0a1f-4db3-82ea-ddd977769a60>`_

Test Suites & 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.2018.08' without
further specification will run all the test cases in the OVP 2018.08 release. Test suites are
divided into test areas that can be executed separately.

Test areas 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 2018.08 release. However, execution of these cases is encouraged, as some
optional test cases may become mandatory in future releases.

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 2018.08 release.

**Mandatory**

- functest.vping.userdata (1)
- functest.vping.ssh (1)
- bottlenecks.stress.ping (1)
- functest.tempest.osinterop (204)
- 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 (40)
- functest.tempest.ipv6_api (21)
- functest.security.patrole (119)
- 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 443 mandatory test cases.

**Optional**

- functest.vnf.vims (1)
- functest.vnf.vepc (1)
- functest.snaps.smoke  (1)
- yardstick.ha.neutron_l3_agent  (1)
- yardstick.ha.controller_restart (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 (15)
- functest.bgpvpn.subnet_connectivity (1)
- functest.bgpvpn.tenant_separation (1)
- functest.bgpvpn.router_association (1)
- functest.bgpvpn.router_association_floating_ip (1)


There are a total of 61 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


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

Upon successful community review of results for OVP 2018.08, 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 '2018.08' corresponds to a reference SUT that aligns to the OPNFV Fraser release and
currently aligns to the Dovetail framework version 2.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 2018.08 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.2.0.0                             |
|                                      |                                       |
+--------------------------------------+---------------------------------------+
| **Release designation**              | OPNFV Verified Program (OVP)          |
|                                      | 2018.08 (Fraser)                      |
+--------------------------------------+---------------------------------------+
| **Release date**                     | August xxxx 2018                      |
|                                      |                                       |
+--------------------------------------+---------------------------------------+
| **Purpose of the delivery**          | Support OVP 2018.08 release with      |
|                                      | OPNFV Fraser release as reference SUT |
+--------------------------------------+---------------------------------------+

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

Software
--------
+-------------------------+-----------------------------------+---------------+
|  **Docker Container**   | **Docker Image**                  | **Tag**       |
+-------------------------+-----------------------------------+---------------+
|   dovetail              |    opnfv/dovetail                 |    ovp.2.0.0  |
+-------------------------+-----------------------------------+---------------+
|   functest              |    opnfv/functest-smoke           |    fraser     |
+-------------------------+-----------------------------------+---------------+
|   functest              |    opnfv/functest-healthcheck     |    fraser     |
+-------------------------+-----------------------------------+---------------+
|   functest              |    opnfv/functest-features        |    fraser     |
+-------------------------+-----------------------------------+---------------+
|   functest              |    opnfv/functest-vnf             |    fraser     |
+-------------------------+-----------------------------------+---------------+
|   yardstick             |    opnfv/yardstick                |    stable     |
+-------------------------+-----------------------------------+---------------+
|   bottlenecks           |    opnfv/bottlenecks              |    stable     |
+-------------------------+-----------------------------------+---------------+


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-features Docker images <https://hub.docker.com/r/opnfv/functest-features/>`_
- `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/>`_



Documents
---------

- `System Preparation Guide <http://docs.opnfv.org/en/stable-fraser/submodules/dovetail/docs/testing/user/systempreparation/index.html>`_

- `User Guide <http://docs.opnfv.org/en/stable-fraser/submodules/dovetail/docs/testing/user/userguide/testing_guide.html>`_

- `OPV Test Specifications <http://docs.opnfv.org/en/stable-fraser/submodules/dovetail/docs/testing/user/testspecification/index.html>`_

- `Dovetail CLI Reference <http://docs.opnfv.org/en/stable-fraser/submodules/dovetail/docs/testing/user/userguide/cli_reference.html>`_

- `OPV Workflow <http://docs.opnfv.org/en/stable-fraser/submodules/dovetail/docs/testing/user/certificationworkflow/index.html>`_

- `OPV Reviewer Guide <http://docs.opnfv.org/en/stable-fraser/submodules/dovetail/docs/testing/user/reviewerguide/index.html>`_


Testing with OPNFV Fraser Installers
====================================

OVP 2018.08 and Dovetail 2.0.0 are known to be have been tested with the following OPNFV
Fraser installer versions.

+-----------------+----------------------+
|   Installer     |      Version         |
+=================+======================+
|   Apex          |      fraser.x.x      |
+-----------------+----------------------+
|   Compass       |      fraser.x.x      |
+-----------------+----------------------+
|   Fuel          |      fraser.x.x      |
+-----------------+----------------------+


Fraser Known Restrictions/Issues
================================

Please refer to the following link for known issues with the Dovetail Fraser release:

.. https://wiki.opnfv.org/display/dovetail/Running+history+for+the+dovetail+tool#Runninghistoryforthedovetailtool-4.KnownIssuesList

Open JIRA Tickets
=================

+------------------+-----------------------------------------------+
|   JIRA           |         Description                           |
+==================+===============================================+
|                  |                                               |
|   xxxxxx         |                                               |
+------------------+-----------------------------------------------+

All blocking tickets have been fixed.


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

 - `OVP Web Portal <https://verified.opnfv.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/dovetail/compliance/ovp.1.0.0.yml>`_