summaryrefslogtreecommitdiffstats
path: root/docs/release-notes/functest-release.rst
blob: 0c1f61f7450a2e1bf0a8c3f48233281d6f629d17 (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
===========================================
OPNFV Brahmaputra release note for Functest
===========================================

Abstract
========

This document describes the release note of Functest project.

License
=======

OPNFV Brahmaputra release note for Functest Docs
(c) by Morgan Richomme (Orange)

OPNFV Brahmaputra release note for Functest 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/>.

Version history
===============

+------------+----------+------------------+------------------------+
| **Date**   | **Ver.** | **Author**       | **Comment**            |
|            |          |                  |                        |
+------------+----------+------------------+------------------------+
| 2016-02-25 | 1.0.0    | Morgan Richomme  | Functest for B release |
|            |          | (Orange)         |                        |
+------------+----------+------------------+------------------------+

OPNFV Brahmaputra Release
=========================

Functest deals with functional testing of the OPNFV solution.
It includes test cases developed within the project and test cases developed in
other OPNFV projects and other upstream communities.

The internal test cases are:

 * vPing ssh
 * vPing userdata
 * Tempest
 * Rally
 * vIMS
 * ODL

The OPNFV projects integrated into Functest framework for automation are:

 * Promise
 * Doctor
 * ONOSFW

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

+--------------------------------------+--------------------------------------+
| **Project**                          | functest                             |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Repo/tag**                         | brahmaputra.1.0                      |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Release designation**              | Brahmaputra base release             |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Release date**                     | February 26 2016                     |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Purpose of the delivery**          | Brahmaputra base release             |
|                                      |                                      |
+--------------------------------------+--------------------------------------+

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

Software
--------

 - The Functest Docker image

Documents
---------

 - Installation/configuration guide

 - User Guide

 - Developer Guide

 - Test results per scenario

Version change
==============

Feature evolution
-----------------

 - dockerization of Functest

 - renaming of vPing into vPing userdata

 - Tempest update, use custom list of test cases

 - Rally update, use global scenario

 - Update jenkins logs

 - support of the different scenarios

New features
------------

 - introduction of a new vPing test case vPing ssh

 - introduction of vIMS test case

 - support of Promise

 - support of Doctor

 - support of ONOSFW

 - scenario management system

 - creation of a Test collection API

 - creation of the Test dashboard: https://www.opnfv.org/opnfvtestgraphs/summary

 - creation of Functest dashboard: http://testresults.opnfv.org/dashboard/

Scenario Matrix
===============

For Brahmaputra, Functest supports the following scenarios:

+----------------+---------+---------+---------+---------+
|    Scenario    |  Apex   | Compass |  Fuel   |   Joid  |
+================+=========+=========+=========+=========+
|   odl_l2       |    X    |    X    |    X    |    X    |
+----------------+---------+---------+---------+---------+
|   onos         |         |    X    |         |         |
+----------------+---------+---------+---------+---------+
|   nosdn        |         |    X    |    X    |         |
+----------------+---------+---------+---------+---------+
|   ovs (dpdk)   |         |         |    X    |         |
+----------------+---------+---------+---------+---------+

Functest defines the success criteria when having at least 4 consecutive
successful runs of a given scenario from the Continuous Integration.

The success criteria is defined as follows:

 * vPing SSH 100% OK
 * vPing userdata 100% OK
 * Tempest success rate > 90%
 * Rally success rate > 90%
 * ODL success rate = 100%
 * ONOSFW success rate = 100%
 * Promise success rate = 100%
 * vIMS: deployement of the orchestrator and the vIMS VNF successful

Other scenarios are currently available but did not meet success criteria for
the release but might be added in the incremental scenario update of the
release.

Brahmaputra limitations
-----------------------

- Fuel and Apex Tempest success rate was below 90% but above 80%. Some of the
error causes were identified (workers, lack of IP)

- vIMS failed in CI for joid/odl_l2 scenario

- vPing userdata and vIMS excluded from onos scenario

- None of the odl_l3 scenarios has been successful due to vPing ssh issue.

- joid/nosdn successful but the complete scenario not run 4 times in a raw

- apex/nosdn never run (not a target scenario) but probably succesful

See known issues section for details

Test and installer/scenario dependencies
========================================

It is not always possible to run all the test cases on all the scenarios. The
following table details the dependencies of the test cases per scenario.

+----------------+-------------+-------------+-------------+-------------+
|  Test cases    |    Apex     |   Compass   |    Fuel     |     Joid    |
+================+=============+=============+=============+=============+
|   vPing SSH    | all         | all         | all         | all         |
+----------------+-------------+-------------+-------------+-------------+
| vPing userdata | all except  | all except  | all except  | all except  |
|                | ONOS        | ONOS        | ONOS        | ONOS        |
+----------------+-------------+-------------+-------------+-------------+
| Tempest        | all         | all         | all         | all         |
+----------------+-------------+-------------+-------------+-------------+
| Rally          | all         | all         | all         | all         |
+----------------+-------------+-------------+-------------+-------------+
| ODL            | all ODL     | all ODL     | all ODL     | all ODL     |
+----------------+-------------+-------------+-------------+-------------+
| ONOS           | ONOS        | ONOS        | ONOS        | ONOS        |
+----------------+-------------+-------------+-------------+-------------+
| Promise        | no          | no          | all         | all         |
+----------------+-------------+-------------+-------------+-------------+
| vIMS           | all except  | all except  | all except  | all except  |
|                | ONOS        | ONOS        | ONOS        | ONOS        |
+----------------+-------------+-------------+-------------+-------------+
| Doctor         | all         | no          | no          | no          |
+----------------+-------------+-------------+-------------+-------------+

Test results
============

Test results are available in:

 - test results document: http://artifacts.opnfv.org/functest/docs/results/index.html

 - jenkins logs on CI: https://build.opnfv.org/ci/view/functest/

 - Test dashboards: http://testresults.opnfv.org/dashboard

Known issues
------------

 - nova metadata service not supported in ONOS:

    - it excludes vPing userdata and vIMS test cases

 - Rally worker issues:

    - A workaround has been implemented to run Tempest test cases sequentially

    - It may explain why Tempest scenarios (mainly on apex) do not run the 210 tests

    - https://bugs.launchpad.net/testrepository/+bug/1538941

 - IPv6 issues in tempest suite:

    - tempest.api.network.test_ports.PortsIpV6TestJSON.test_create_port_in_allowed_allocation_pools

    - Tempest code which doesn't reserve big enough allocation

    - https://bugs.launchpad.net/tempest/+bug/1514457

 - Lack of IP addresses available lead to several errors in different test cases

 - vIMS:

    - the VM needs to have access to OpenStack API.

    - Technical architecture may not allow this access (for security reasons)

    - Orchestrator can be deployed but the vIMS VNF cannot

    - That is the reason why it fails on joid/odl_l2 scenario on Orange POD 2

Open JIRA tickets
=================

+------------------+-----------------------------------------+
|   JIRA           |         Description                     |
+==================+=========================================+
| FUNCTEST-139     | prepare_env failed due to               |
|                  | https://pypi.python.org/samples is not  |
|                  | accessible                              |
+------------------+-----------------------------------------+
| FUNCTEST-137     | Tempest success rate below 90 on apex   |
+------------------+-----------------------------------------+
| FUNCTEST-136     | Tempest success rate below 90 on fuel   |
+------------------+-----------------------------------------+
| FUNCTEST-135     | vPing scenario failed in odl_l3 scenario|
+------------------+-----------------------------------------+
| FUNCTEST-124     | odl test suite troubleshooting          |
+------------------+-----------------------------------------+

Useful links
============

 - wiki project page: https://wiki.opnfv.org/opnfv_functional_testing

 - Functest repo: https://git.opnfv.org/cgit/functest

 - Functest CI dashboard: https://build.opnfv.org/ci/view/functest/

 - JIRA dashboard: https://jira.opnfv.org/secure/Dashboard.jspa?selectPageId=10611

 - Wiki page for B Release: https://wiki.opnfv.org/functest_release_2

 - Functest IRC chan: #opnfv-testperf

 - Test dashboard: https://www.opnfv.org/opnfvtestgraphs/summary

 - Functest dashboard: http://testresults.opnfv.org/dashboard