4 OPNFV Colorado release note for Functest Docs
5 (c) by Morgan Richomme (Orange)
7 OPNFV Colorado release note for Functest Docs
8 are licensed under a Creative Commons Attribution 4.0 International License.
9 You should have received a copy of the license along with this.
10 If not, see <http://creativecommons.org/licenses/by/4.0/>.
12 ===========================================
13 OPNFV Colorado1.0 release note for Functest
14 ===========================================
19 This document describes the release note of Functest project.
25 +------------+----------+------------------+------------------------+
26 | **Date** | **Ver.** | **Author** | **Comment** |
28 +------------+----------+------------------+------------------------+
29 | 2016-08-17 | 1.0.0 | Morgan Richomme | Functest for Colorado |
30 | | | (Orange) | release |
31 +------------+----------+------------------+------------------------+
33 OPNFV Colorado Release
34 =========================
36 Functest deals with functional testing of the OPNFV solution.
37 It includes test cases developed within the project and test cases developed in
38 other OPNFV projects and other upstream communities.
40 The internal test cases are:
45 * Tempest Smoke Serial
48 * Tempest full parallel
52 The OPNFV projects integrated into Functest framework for automation are:
67 The validation of a scenario requires a subset of these tests depending
68 on the installer and the scenario.
70 The 3 last internal test cases (tempest full parallel, Rally full and
71 vIMS) are not considered for scenario validation.
76 +--------------------------------------+--------------------------------------+
77 | **Project** | functest |
79 +--------------------------------------+--------------------------------------+
80 | **Repo/tag** | colorado.1.0 |
82 +--------------------------------------+--------------------------------------+
83 | **Release designation** | Colorado base release |
85 +--------------------------------------+--------------------------------------+
86 | **Release date** | September 22 2016 |
88 +--------------------------------------+--------------------------------------+
89 | **Purpose of the delivery** | Colorado base release |
91 +--------------------------------------+--------------------------------------+
99 - The Functest Docker image: * TODO link *
101 - The testapi Docker image: * TODO link *
107 - Installation/configuration guide: http://artifacts.opnfv.org/functest/colorado/docs/configguide/index.html
109 - User Guide: http://artifacts.opnfv.org/functest/colorado/docs/userguide/index.html
111 - Developer Guide: http://artifacts.opnfv.org/functest/colorado/docs/devguide/index.html
120 - refactoring of ODL functional tests (with upstream modifications)
122 - refactoring of testapi (update, swagger documentation, dockerization)
124 - jenkins logs improvement
126 - update integration of Doctor, Promise and SDNVPN projects
128 - split Tempest and rally into 2 different tests: smoke and full
130 - vIMS test suite integration
132 - adoption of Kibana for dashboarding
138 - Functest CLI to prepare and run the tests
140 - creation of the healthcheck test case
142 - support new scenarios (ocl, odl_l2-sfc, onos-sfc, lxd, moon, fdio, multisite)
144 - integration of new OPNFV feature projects (copper, domino, multisite,
145 moon, parser, onos-sfc, odl-sfc, security scan)
147 - introduction of test tiers in functest framework
149 - automatic reporting
151 - introduction of a jenkins summary table
153 - support of ARM architecture
159 For Colorado 1.0, Functest was tested on the following scenarios (if not
160 precised, the scenario is a HA scenario):
162 +---------------------+---------+---------+---------+---------+
163 | Scenario | Apex | Compass | Fuel | Joid |
164 +=====================+=========+=========+=========+=========+
165 | nosdn | X | X | X | X |
166 +---------------------+---------+---------+---------+---------+
167 | nosdn-noha | | | X | X |
168 +---------------------+---------+---------+---------+---------+
169 | odl_l2 | X | X | X | X |
170 +---------------------+---------+---------+---------+---------+
171 | odl_l2-noha | | | X | |
172 +---------------------+---------+---------+---------+---------+
173 | odl_l3 | X | X | X | |
174 +---------------------+---------+---------+---------+---------+
175 | odl_l3-noha | | | X | |
176 +---------------------+---------+---------+---------+---------+
177 | odl_l2-bgpvpn | X | | X | |
178 +---------------------+---------+---------+---------+---------+
179 | odl_l2-bgpvpn-noha| | | X | |
180 +---------------------+---------+---------+---------+---------+
181 | odl_l2-fdio-noha | X | | | |
182 +---------------------+---------+---------+---------+---------+
183 | odl_l2-moon | | X | | |
184 +---------------------+---------+---------+---------+---------+
185 | odl_l2-sfc | | | X | |
186 +---------------------+---------+---------+---------+---------+
187 | odl_l2-sfc-noha | X | | X | |
188 +---------------------+---------+---------+---------+---------+
189 | onos | | X | X | X |
190 +---------------------+---------+---------+---------+---------+
191 | onos-noha | | | X | |
192 +---------------------+---------+---------+---------+---------+
193 | onos-sfc | | X | X | X |
194 +---------------------+---------+---------+---------+---------+
195 | onos-sfc-noha | | | X | |
196 +---------------------+---------+---------+---------+---------+
197 | ovs-noha (dpdk) | | | X | |
198 +---------------------+---------+---------+---------+---------+
200 +---------------------+---------+---------+---------+---------+
201 | kvm-noha | | | X | |
202 +---------------------+---------+---------+---------+---------+
203 | multisite | | | X | |
204 +---------------------+---------+---------+---------+---------+
206 +---------------------+---------+---------+---------+---------+
207 | lxd-noha | | | | X |
208 +---------------------+---------+---------+---------+---------+
210 In Colorado, the functional tests have been sliced in 6 different
213 +----------------+-----------------------------------------------+
214 | Category | Description |
215 +================+===============================================+
216 | healthcheck | Basic OpenStack commands |
217 +----------------+-----------------------------------------------+
218 | smoke | vPings, Tempest and rally smoke tests |
219 +----------------+-----------------------------------------------+
220 | sdn_suites | Specific SDN feature tests |
221 +----------------+-----------------------------------------------+
222 | features | OPNFV feature project functional test suites |
223 +----------------+-----------------------------------------------+
224 | openstack | Advanced, long duration OpenStack tests |
225 | | (Tempest and Rally full suite). Each test may |
226 | | last several hours |
227 +----------------+-----------------------------------------------+
228 | vnf | Complex scenarios dealing with orchestration, |
229 | | VNF deployment and tests (e.g. vIMS) |
230 +----------------+-----------------------------------------------+
232 For the scenario validation, we consider only the healthcheck, smoke,
233 sdn_suites and features categories. These tests are run systematically
234 in the CI daily loops.
236 Success criteria have been defined for these test cases, they can be
237 PASS/FAIL or a success rate may be declared (100%, > 90%)
238 All the criteria, as well as the test dependencies are declared in the
239 ci/testcases.yaml file.
241 The scoring for the Colorado release per installer can be described as
244 The scoring is an indicator showing how many feature project test suites
245 have been integrated on the scenario.
247 The scoring equals the number of tests * succesful iteration of each
248 test [0-3]. The scoring method is described in https://wiki.opnfv.org/pages/viewpage.action?pageId=6828617
251 apex/odl_l2-nofeature-ha
252 tests = vping_ssh+vping_userdata+tempest+rally+odl+doctor+copper
253 Scoring = 21/21 = 7 * 3
255 By default, if not precised, the scenarios are HA.
256 HA means OpenStack High Availability (main services). For copper test,
257 the OpenStack congress module is not HA. See the release notes of the
258 installers for details.
264 +------------------+---------+---------+-------------------+
265 | Scenario | Scoring | Success | Results |
267 +==================+=========+=========+===================+
268 | nosdn | 17/18 | 95% | `apex-res-174`_ |
269 +------------------+---------+---------+-------------------+
270 | odl_l2 | 21/21 | 100% | `apex-res-175`_ |
271 +------------------+---------+---------+-------------------+
272 | odl_l3 | 15/18 | 83% | `apex-res-176`_ |
273 +------------------+---------+---------+-------------------+
274 | odl_l2-bgpvpn | 14/18 | 78% | ?? |
275 +------------------+---------+---------+-------------------+
276 | odl_l2-fdio-noha | 11/15 | 73% | ?? |
277 +------------------+---------+---------+-------------------+
278 | odl_l2-sfc-noha | 18/21 | 86% | ?? |
279 +------------------+---------+---------+-------------------+
284 +------------------+---------+---------+-------------------+
285 | Scenario | Scoring | Success | Results |
287 +==================+=========+=========+===================+
288 | nosdn | 12/12 | 100% | `compass-res-55`_ |
289 +------------------+---------+---------+-------------------+
290 | odl_l2 | 15/15 | 100% | `compass-res-59`_ |
291 +------------------+---------+---------+-------------------+
292 | odl_l3 | 9/12 | 75% | `compass-res-73`_ |
293 +------------------+---------+---------+-------------------+
294 | odl_l2-moon | 9/18 | % | ?? |
295 +------------------+---------+---------+-------------------+
296 | onos-ha | 15/15 | 100% | `compass-res-77`_ |
297 +------------------+---------+---------+-------------------+
298 | onos-sfc-ha | 16/18 | 100% | `compass-res-76`_ |
299 +------------------+---------+---------+-------------------+
301 Note: all the Compass tests for Colorado have been executed on virtual
302 environment. Bare metal resources were used for Master branch.
308 +---------------------+---------+---------+-------------------+
309 | Scenario | Scoring | Success | Results |
311 +=====================+=========+=========+===================+
312 | nosdn | 18/18 | 100% | `fuel-res-129`_ |
313 +---------------------+---------+---------+-------------------+
314 | nosdn-noha | 15/15 | 100% | `fuel-res-154`_ |
315 +---------------------+---------+---------+-------------------+
316 | nosdn-kvm | 18/18 | 100% | `fuel-res-128`_ |
317 +---------------------+---------+---------+-------------------+
318 | nosdn-kvm-noha | 15/15 | 100% | `fuel-res-161`_ |
319 +---------------------+---------+---------+-------------------+
320 | nosdn-ovs-noha | 15/15 | 100% | `fuel-res-162`_ |
321 +---------------------+---------+---------+-------------------+
322 | odl_l2-sfc | 21/21 | 100% | |
323 +---------------------+---------+---------+-------------------+
324 | odl_l2-sfc-noha | 16/18 | 88% | |
325 +---------------------+---------+---------+-------------------+
326 | odl_l2 | 21/21 | 100% | `fuel-res-123`_ |
327 +---------------------+---------+---------+-------------------+
328 | odl_l2-noha | 17/18 | 94% | `fuel-res-155`_ |
329 +---------------------+---------+---------+-------------------+
330 | odl_l2-bgpvpn | 17/18 | 94% | `fuel-res-119`_ |
331 +---------------------+---------+---------+-------------------+
332 | odl_l2-bgpvpn-noha | 15/15 | 100% | `fuel-res-160`_ |
333 +---------------------+---------+---------+-------------------+
334 | odl_l3 | 15/18 | 67% | `fuel-res-115`_ |
335 +---------------------+---------+---------+-------------------+
336 | odl_l3-noha | 12/15 | 80% | `fuel-res-164`_ |
337 +---------------------+---------+---------+-------------------+
338 | onos | 20/21 | 95% | `fuel-res-117`_ |
339 +---------------------+---------+---------+-------------------+
340 | onos-noha | 18/18 | 100% | `fuel-res-166`_ |
341 +---------------------+---------+---------+-------------------+
342 | onos-sfc | 24/24 | 100% | fuel-res-124`_ |
343 +---------------------+---------+---------+-------------------+
344 | onos-sfc-noha | 21/21 | 100% | `fuel-res-129`_ |
345 +---------------------+---------+---------+-------------------+
346 | multisite | N.R | 100% | `fuel-res-8`_ |
347 +---------------------+---------+---------+-------------------+
352 +---------------------+---------+---------+-----------------+
353 | Scenario | Scoring | Success | Results |
355 +=====================+=========+=========+=================+
356 | nosdn | 18/18 | 100% | `joid-res-102`_ |
357 +---------------------+---------+---------+-----------------+
358 | nosdn-noha | 17/18 | 95% | `joid-res-93`_ |
359 +---------------------+---------+---------+-----------------+
360 | nosdn-lxd | 12/12 | 100% | `joid-res-104`_ |
361 +---------------------+---------+---------+-----------------+
362 | nosdn-lxd-noha | 12/12 | 100% | `joid-res-91`_ |
363 +---------------------+---------+---------+-----------------+
364 | odl_l2 | 19/21 | 91% | `joid-res-103`_ |
365 +---------------------+---------+---------+-----------------+
366 | onos | 21/21 | 100% | `joid-res-99`_ |
367 +---------------------+---------+---------+-----------------+
368 | onos-sfc | 24/24 | 100% | `joid-res-97`_ |
369 +---------------------+---------+---------+-----------------+
371 It is highly recommended to install a json viewer in your browser
372 (e.g. https://addons.mozilla.org/fr/firefox/addon/jsonview/)
374 You can get additional details through test logs on http://artifacts.opnfv.org/.
375 As no search engine is available on the OPNFV artifact web site you must
376 retrieve the pod identifier on which the tests have been executed (see
377 field pod in any of the results) then click on the selected POD and look
378 for the date of the test you are interested in.
380 The reporting pages can be found at:
382 * apex: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-apex.html
383 * compass: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-compass.html
384 * fuel: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-fuel.html
385 * joid: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-joid.html
387 Colorado known restrictions/issues
388 ==================================
390 +-----------+-----------+----------------------------------------------+
391 | Installer | Scenario | Issue |
392 +===========+===========+==============================================+
393 | any | odl_l3-* | Tempest cases related to using floating IP |
394 | | | addresses fail because of a known ODL bug. |
395 | | | vPing_ssh test case is excluded for the same |
397 | | | https://jira.opnfv.org/browse/APEX-112 |
398 | | | https://jira.opnfv.org/browse/FUNCTEST-445 |
399 +-----------+-----------+----------------------------------------------+
400 | apex/fuel | *-bgpvpn | vPing_ssh (floating ips not supported) and |
401 | | | vIMS excluded. Some Tempest cases related to |
402 | | | floating ips also excluded. Some performance |
403 | | | issues have been detected in this scenario |
404 | | | (i.e. BGPVPN extension enabled) when running |
405 | | | commands against the OpenStack APIs, thus |
406 | | | Rally sanity test case has been disabled. |
407 | | | Performance issues seem to be connected to |
408 | | | the ODL version. It is planned to reintroduce|
409 | | | Rally sanity in Colorado 2.0 with the |
410 | | | adoption of ODL Boron release. |
411 +-----------+-----------+----------------------------------------------+
412 | apex | *-fdio | Due to late integration, fdio decided to |
413 | | | focus on mandatory tests and exclude feature |
414 | | | tests (copper, doctor, security_scan) from |
415 | | | its scenarios |
416 +-----------+-----------+----------------------------------------------+
417 | compass | moon | First ODL test FAILS because ODL/Openstack |
418 | | | federation done in moon is partial. Only |
419 | | | MD-SAL is federated (not AD-SAL) |
420 +-----------+-----------+----------------------------------------------+
421 | fuel | any | TestServerBasicOps test case skipped |
422 | | | https://gerrit.opnfv.org/gerrit/#/c/19635/ |
423 +-----------+-----------+----------------------------------------------+
424 | fuel | kvm | vPing_ssh and vIMS excluded (metadata related|
426 +-----------+-----------+----------------------------------------------+
427 | fuel | multisite | random errors running multisite. A known bug |
428 | | | in keystone mitaka, due to which memcache |
429 | | | raises exception and keystone becomes |
431 | | | bugs.launchpad.net/keystone/+bug/1600394 |
432 | | | workaround consists in restarting memcache on|
434 +-----------+-----------+----------------------------------------------+
435 | joid | any | Tempest cases related to object storage |
437 | | | https://gerrit.opnfv.org/gerrit/#/c/17871/ |
438 +-----------+-----------+----------------------------------------------+
439 | joid | domino | Domino tests are skipped in CI. However the |
440 | | | test case can be run by manually setting |
441 | | | IS_IPandKEY_CONFIGURED=true after manually |
442 | | | setting properly the IP addresses of the 3 |
443 | | | Controller nodes in the configuration file |
444 | | | /repos/domino/tests/run_multinode.sh |
445 +-----------+-----------+----------------------------------------------+
448 Test and installer/scenario dependencies
449 ========================================
451 It is not always possible to run all the test cases on all the scenarios.
452 The following table details the dependencies of the test cases per
453 scenario. The scenario dependencies (installer or scenario) are detailed
454 in https://git.opnfv.org/cgit/functest/tree/ci/testcases.yaml
459 Test results are available in:
461 - test results document: http://artifacts.opnfv.org/functest
463 - jenkins logs on CI: https://build.opnfv.org/ci/view/functest/
465 - jenkins logs on ARM CI: https://build.opnfv.org/ci/view/armband/
472 +------------------+-----------------------------------------------+
473 | JIRA | Description |
474 +==================+===============================================+
475 | `FUNCTEST-419`_ | do not try to Remove docker |
476 | | image opnfv/functest:<none> |
477 | | reported by joid on Intel POD |
479 | | not reproducible |
480 +------------------+-----------------------------------------------+
481 | `FUNCTEST-446`_ | Cleanup ODL-SFC output in Functest execution |
482 | | Impact on odl_l2-sfc scenarios |
483 +------------------+-----------------------------------------------+
484 | `FUNCTEST-450`_ | Functest is Failing to get the token using |
485 | | keystone client |
486 +------------------+-----------------------------------------------+
487 | `FUNCTEST-454`_ | Cleanup failures when using HA networks in |
489 +------------------+-----------------------------------------------+
490 | `FUNCTEST-460`_ | Wrong image format used in rally cases |
491 +------------------+-----------------------------------------------+
492 | `FUNCTEST-462`_ | OLD test fails after forcing the clone |
493 | | release/beryllium-sr3 branch |
494 +------------------+-----------------------------------------------+
500 - wiki project page: https://wiki.opnfv.org/opnfv_functional_testing
502 - wiki Functest Colorado page: https://wiki.opnfv.org/display/functest/Functest+Colorado
504 - Functest repo: https://git.opnfv.org/cgit/functest
506 - Functest CI dashboard: https://build.opnfv.org/ci/view/functest/
508 - JIRA dashboard: https://jira.opnfv.org/secure/Dashboard.jspa?selectPageId=10611
510 - Functest IRC chan: #opnfv-functest
512 - Functest reporting: http://testresults.opnfv.org/reporting
514 - Functest test configuration: https://git.opnfv.org/cgit/functest/tree/ci/testcases.yaml
516 - Functest Colorado user guide: http://artifacts.opnfv.org/functest/colorado/docs/userguide/index.html
518 - Functest installation/configuration guide: http://artifacts.opnfv.org/functest/colorado/docs/configguide/index.html
520 - Functest developer guide: http://artifacts.opnfv.org/functest/colorado/docs/devguide/index.html
522 .. _`FUNCTEST-419` : https://jira.opnfv.org/browse/FUNCTEST-419
524 .. _`FUNCTEST-446` : https://jira.opnfv.org/browse/FUNCTEST-446
526 .. _`FUNCTEST-450` : https://jira.opnfv.org/browse/FUNCTEST-450
528 .. _`FUNCTEST-454` : https://jira.opnfv.org/browse/FUNCTEST-454
530 .. _`FUNCTEST-460` : https://jira.opnfv.org/browse/FUNCTEST-460
532 .. _`FUNCTEST-462` : https://jira.opnfv.org/browse/FUNCTEST-462
534 .. _`apex-res-174` : http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-174
536 .. _`apex-res-175`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-175
538 .. _`apex-res-176`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-176
540 .. _`compass-res-55`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-55
542 .. _`compass-res-59`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-59
544 .. _`compass-res-73`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-73
546 .. _`compass-res-76`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-76
548 .. _`compass-res-77`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-77
550 .. _`fuel-res-129`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-129
552 .. _`fuel-res-154`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-154
554 .. _`fuel-res-128`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-128
556 .. _`fuel-res-161`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-161
558 .. _`fuel-res-162`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-162
560 .. _`fuel-res-119`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-119
562 .. _`fuel-res-160`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-160
564 .. _`fuel-res-115`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-115
566 .. _`fuel-res-117`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-117
568 .. _`fuel-res-124`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-124
570 .. _`fuel-res-8`: https://build.opnfv.org/ci/view/functest/job/functest-fuel-virtual-suite-colorado/lastSuccessfulBuild/console
572 .. _`fuel-res-164`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-164
574 .. _`fuel-res-166`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-166
576 .. _`fuel-res-155`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-155
578 .. _`fuel-res-123`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-123
580 .. _`joid-res-102`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-102
582 .. _`joid-res-93`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-93
584 .. _`joid-res-104`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-104
586 .. _`joid-res-91`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-91
588 .. _`joid-res-99`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-99
590 .. _`joid-res-97`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-97
592 .. _`joid-res-103`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-103