1. OPNFV Brahmaputra release note for Functest

1.1. Abstract

This document describes the release note of Functest project.

1.2. 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/>.

1.3. Version history

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

1.4. 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

1.5. 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

1.6. Deliverables

1.6.1. Software

  • The Functest Docker image

1.6.2. Documents

  • Installation/configuration guide
  • User Guide
  • Developer Guide
  • Test results per scenario

1.7. Version change

1.7.1. 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

1.7.2. New features

1.8. 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.

1.8.1. 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

1.9. 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 ONOS all except ONOS all except ONOS all except 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 ONOS all except ONOS all except ONOS all except ONOS
Doctor all no no no

1.10. Test results

Test results are available in:

1.10.1. Known issues

  • nova metadata service not supported in ONOS:

    • it excludes vPing userdata and vIMS test cases

  • Rally worker issues:

  • IPv6 issues in tempest suite:

  • 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

1.11. 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