summaryrefslogtreecommitdiffstats
path: root/docs/release
diff options
context:
space:
mode:
authorJose Lausuch <jose.lausuch@ericsson.com>2017-03-01 13:37:13 +0000
committerGerrit Code Review <gerrit@opnfv.org>2017-03-01 13:37:13 +0000
commitb8935ad451dd2650b42c7976af2722da7ca720af (patch)
treeadcf1b3bf97ec5e8be492653f5936c708b7cd456 /docs/release
parent4e0ebc01f1fa41d1b15f7d135c3769a051b1667c (diff)
parent83714aaa9a09e7df27e06d5d95dadc89a8e67f9e (diff)
Merge "Restructure docs"
Diffstat (limited to 'docs/release')
-rw-r--r--docs/release/release-notes/functest-release.rst637
-rw-r--r--docs/release/release-notes/index.rst15
2 files changed, 652 insertions, 0 deletions
diff --git a/docs/release/release-notes/functest-release.rst b/docs/release/release-notes/functest-release.rst
new file mode 100644
index 000000000..07389bb5b
--- /dev/null
+++ b/docs/release/release-notes/functest-release.rst
@@ -0,0 +1,637 @@
+=======
+License
+=======
+
+OPNFV Colorado release note for Functest Docs
+(c) by Morgan Richomme (Orange)
+
+OPNFV Colorado 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/>.
+
+===========================================
+OPNFV Colorado1.0 release note for Functest
+===========================================
+
+Abstract
+========
+
+This document describes the release note of Functest project.
+
+
+Version history
+===============
+
++------------+----------+------------------+------------------------+
+| **Date** | **Ver.** | **Author** | **Comment** |
+| | | | |
++------------+----------+------------------+------------------------+
+| 2016-08-17 | 1.0.0 | Morgan Richomme | Functest for Colorado |
+| | | (Orange) | release |
++------------+----------+------------------+------------------------+
+
+OPNFV Colorado 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:
+
+ * healthcheck
+ * vPing ssh
+ * vPing userdata
+ * Tempest Smoke Serial
+ * Rally Sanity
+ * ODL
+ * Tempest full parallel
+ * Rally full
+ * vIMS
+
+The OPNFV projects integrated into Functest framework for automation are:
+
+ * bgpvpn
+ * Copper
+ * Doctor
+ * Domino
+ * Moon
+ * Multisite
+ * ONOSFW
+ * ONOS-sfc
+ * ODL-sfc
+ * Parser
+ * Promise
+ * Security scan
+
+The validation of a scenario requires a subset of these tests depending
+on the installer and the scenario.
+
+The 3 last internal test cases (tempest full parallel, Rally full and
+vIMS) are not considered for scenario validation.
+
+Release Data
+============
+
++--------------------------------------+--------------------------------------+
+| **Project** | functest |
+| | |
++--------------------------------------+--------------------------------------+
+| **Repo/tag** | colorado.1.0 |
+| | |
++--------------------------------------+--------------------------------------+
+| **Release designation** | Colorado base release |
+| | |
++--------------------------------------+--------------------------------------+
+| **Release date** | September 22 2016 |
+| | |
++--------------------------------------+--------------------------------------+
+| **Purpose of the delivery** | Colorado base release |
+| | |
++--------------------------------------+--------------------------------------+
+
+Deliverables
+============
+
+Software
+--------
+
+ - The Functest Docker image: https://hub.docker.com/r/opnfv/functest (tag: colorado.1.0)
+
+ - The testapi Docker image: https://hub.docker.com/r/opnfv/testapi (tag:colorado.1.0)
+
+
+Documents
+---------
+
+ - Installation/configuration guide: http://artifacts.opnfv.org/functest/colorado/docs/configguide/index.html
+
+ - User Guide: http://artifacts.opnfv.org/functest/colorado/docs/userguide/index.html
+
+ - Developer Guide: http://artifacts.opnfv.org/functest/colorado/docs/devguide/index.html
+
+
+Version change
+==============
+
+Feature evolution
+-----------------
+
+ - refactoring of ODL functional tests (with upstream modifications)
+
+ - refactoring of testapi (update, swagger documentation, dockerization)
+
+ - jenkins logs improvement
+
+ - update integration of Doctor, Promise and SDNVPN projects
+
+ - split Tempest and rally into 2 different tests: smoke and full
+
+ - vIMS test suite integration
+
+ - adoption of Kibana for dashboarding
+
+
+New features
+------------
+
+ - Functest CLI to prepare and run the tests
+
+ - creation of the healthcheck test case
+
+ - support new scenarios (ocl, odl_l2-sfc, onos-sfc, lxd, moon, fdio, multisite)
+
+ - integration of new OPNFV feature projects (copper, domino, multisite,
+ moon, parser, onos-sfc, odl-sfc, security scan)
+
+ - introduction of test tiers in functest framework
+
+ - automatic reporting
+
+ - introduction of a jenkins summary table
+
+ - support of ARM architecture
+
+
+Scenario Matrix
+===============
+
+For Colorado 1.0, Functest was tested on the following scenarios (if not
+precised, the scenario is a HA scenario):
+
++---------------------+---------+---------+---------+---------+
+| Scenario | Apex | Compass | Fuel | Joid |
++=====================+=========+=========+=========+=========+
+| nosdn | X | X | X | X |
++---------------------+---------+---------+---------+---------+
+| nosdn-noha | | | X | X |
++---------------------+---------+---------+---------+---------+
+| kvm | | | X | |
++---------------------+---------+---------+---------+---------+
+| kvm-noha | | | X | |
++---------------------+---------+---------+---------+---------+
+| lxd | | | | X |
++---------------------+---------+---------+---------+---------+
+| lxd-noha | | | | X |
++---------------------+---------+---------+---------+---------+
+| ovs-noha (dpdk) | | | X | |
++---------------------+---------+---------+---------+---------+
+| odl_l2 | X | X | X | X |
++---------------------+---------+---------+---------+---------+
+| odl_l2-noha | | | X | |
++---------------------+---------+---------+---------+---------+
+| odl_l2-bgpvpn | X | | X | |
++---------------------+---------+---------+---------+---------+
+| odl_l2-bgpvpn-noha| | | X | |
++---------------------+---------+---------+---------+---------+
+| odl_l2-fdio-noha | X | | | |
++---------------------+---------+---------+---------+---------+
+| odl_l2-moon | | X | | |
++---------------------+---------+---------+---------+---------+
+| odl_l2-sfc-noha | X | | X | |
++---------------------+---------+---------+---------+---------+
+| odl_l3 | X | X | X | |
++---------------------+---------+---------+---------+---------+
+| odl_l3-noha | | | X | |
++---------------------+---------+---------+---------+---------+
+| onos | | X | X | X |
++---------------------+---------+---------+---------+---------+
+| onos-noha | | | X | |
++---------------------+---------+---------+---------+---------+
+| onos-sfc | | X | X | X |
++---------------------+---------+---------+---------+---------+
+| onos-sfc-noha | | | X | |
++---------------------+---------+---------+---------+---------+
+| multisite | | | X | |
++---------------------+---------+---------+---------+---------+
+
+For Colorado 2.0, the following scenarios have been re-released:
+
++---------------------+---------+---------+---------+---------+
+| Scenario | Apex | Compass | Fuel | Joid |
++=====================+=========+=========+=========+=========+
+| onos | X | X | X | X |
++---------------------+---------+---------+---------+---------+
+| odl_l2-sfc-ha | | | X | |
++---------------------+---------+---------+---------+---------+
+
+
+In Colorado, the functional tests have been sliced in 6 different
+categories:
+
++----------------+-----------------------------------------------+
+| Category | Description |
++================+===============================================+
+| healthcheck | Basic OpenStack commands |
++----------------+-----------------------------------------------+
+| smoke | vPings, Tempest and rally smoke tests |
++----------------+-----------------------------------------------+
+| sdn_suites | Specific SDN feature tests |
++----------------+-----------------------------------------------+
+| features | OPNFV feature project functional test suites |
++----------------+-----------------------------------------------+
+| openstack | Advanced, long duration OpenStack tests |
+| | (Tempest and Rally full suite). Each test may |
+| | last several hours |
++----------------+-----------------------------------------------+
+| vnf | Complex scenarios dealing with orchestration, |
+| | VNF deployment and tests (e.g. vIMS) |
++----------------+-----------------------------------------------+
+
+For the scenario validation, we consider only the healthcheck, smoke,
+sdn_suites and features categories. These tests are run systematically
+in the CI daily loops.
+
+Success criteria have been defined for these test cases, they can be
+PASS/FAIL or a success rate may be declared (100%, > 90%)
+All the criteria, as well as the test dependencies are declared in the
+ci/testcases.yaml file.
+
+The scoring for the Colorado release per installer can be described as
+follows.
+
+The scoring is an indicator showing how many feature project test suites
+have been integrated on the scenario.
+
+The scoring equals the number of tests * succesful iteration of each
+test [0-3]. The scoring method is described in https://wiki.opnfv.org/pages/viewpage.action?pageId=6828617
+
+ e.g.
+ apex/odl_l2-nofeature-ha
+ tests = vping_ssh+vping_userdata+tempest+rally+odl+doctor+copper
+ Scoring = 21/21 = 7 * 3
+
+By default, if not specified, the scenarios are HA.
+HA means OpenStack High Availability (main services). Note that not
+all VIM (e.g. OpenStack) services are deployed in HA mode, as that
+depends upon support of the specific service for HA deployment.
+For example, in the Colorado release, the Congress service
+is deployed in non-HA mode even for HA OPNFV scenarios, as explicit
+support for HA operation has not yet been verified.
+See the release notes of the installers for more details.
+
+
+Apex
+----
+
++------------------+---------+---------+-------------------+
+| Scenario | Scoring | Success | Results |
+| | | rate | |
++==================+=========+=========+===================+
+| nosdn | 17/18 | 95% | `apex-res-174`_ |
++------------------+---------+---------+-------------------+
+| odl_l2 | 21/21 | 100% | `apex-res-175`_ |
++------------------+---------+---------+-------------------+
+| odl_l3 | 15/18 | 83% | `apex-res-176`_ |
++------------------+---------+---------+-------------------+
+| odl_l2-bgpvpn | 14/18 | 78% | `apex-res-235`_ |
++------------------+---------+---------+-------------------+
+| odl_l2-fdio-noha | 12/15 | 80% | `apex-res-6`_ |
++------------------+---------+---------+-------------------+
+| odl_l2-sfc-noha | 18/24 | 75% | `apex-res-217`_ |
++------------------+---------+---------+-------------------+
+| onos-nofeature-ha| 20/21 | 95% | `apex-res-423`_ |
++------------------+---------+---------+-------------------+
+
+
+Compass
+-------
+
++------------------+---------+---------+-------------------+
+| Scenario | Scoring | Success | Results |
+| | | rate | |
++==================+=========+=========+===================+
+| nosdn | 12/12 | 100% | `compass-res-55`_ |
++------------------+---------+---------+-------------------+
+| odl_l2 | 15/15 | 100% | `compass-res-59`_ |
++------------------+---------+---------+-------------------+
+| odl_l3 | 9/12 | 75% | `compass-res-73`_ |
++------------------+---------+---------+-------------------+
+| odl_l2-moon | 15/18 | 83% | `compass-res-567`_|
++------------------+---------+---------+-------------------+
+| onos-ha | 15/15 | 100% | `compass-res-285`_|
++------------------+---------+---------+-------------------+
+| onos-sfc-ha | 17/18 | 95% | `compass-res-76`_ |
++------------------+---------+---------+-------------------+
+
+Note: all the Compass tests for Colorado have been executed on virtual
+environment. Bare metal resources were used for Master branch.
+
+
+Fuel
+----
+
++---------------------+---------+---------+-------------------+
+| Scenario | Scoring | Success | Results |
+| | | rate | |
++=====================+=========+=========+===================+
+| nosdn | 18/18 | 100% | `fuel-res-129`_ |
++---------------------+---------+---------+-------------------+
+| nosdn-noha | 15/15 | 100% | `fuel-res-154`_ |
++---------------------+---------+---------+-------------------+
+| nosdn-kvm | 18/18 | 100% | `fuel-res-128`_ |
++---------------------+---------+---------+-------------------+
+| nosdn-kvm-noha | 15/15 | 100% | `fuel-res-161`_ |
++---------------------+---------+---------+-------------------+
+| nosdn-ovs | 12/18 | 67%* | `fuel-res-213`_ |
++---------------------+---------+---------+-------------------+
+| nosdn-ovs-noha | 15/15 | 100% | `fuel-res-162`_ |
++---------------------+---------+---------+-------------------+
+| odl_l2 | 21/21 | 100% | `fuel-res-123`_ |
++---------------------+---------+---------+-------------------+
+| odl_l2-noha | 17/18 | 94% | `fuel-res-155`_ |
++---------------------+---------+---------+-------------------+
+| odl_l2-bgpvpn | 14/18 | 78% | `fuel-res-119`_ |
++---------------------+---------+---------+-------------------+
+| odl_l2-bgpvpn-noha | 14/15 | 93% | `fuel-res-160`_ |
++---------------------+---------+---------+-------------------+
+| odl_l2-sfc-noha | 6/21 | 29% | `fuel-res-219`_ |
++---------------------+---------+---------+-------------------+
+| odl_l2-sfc-ha | 16/21 | 76% | `fuel-res-376`_ |
++---------------------+---------+---------+-------------------+
+| odl_l3 | 15/18 | 83% | `fuel-res-115`_ |
++---------------------+---------+---------+-------------------+
+| odl_l3-noha | 12/15 | 80% | `fuel-res-164`_ |
++---------------------+---------+---------+-------------------+
+| onos | 20/21 | 95% | `fuel-res-492`_ |
++---------------------+---------+---------+-------------------+
+| onos-noha | 18/18 | 100% | `fuel-res-166`_ |
++---------------------+---------+---------+-------------------+
+| onos-sfc | 24/24 | 100% | `fuel-res-124`_ |
++---------------------+---------+---------+-------------------+
+| onos-sfc-noha | 21/21 | 100% | `fuel-res-129`_ |
++---------------------+---------+---------+-------------------+
+| multisite | N.R | 100% | `fuel-res-8`_ |
++---------------------+---------+---------+-------------------+
+
+*: all results passed, lacking iterations to reach the full score
+
+Results of Functest on AArch64 Colorado 3.0
+
++---------------------+---------+---------+----------------------+
+| Scenario | Scoring | Success | Results |
+| | | rate | |
++=====================+=========+=========+======================+
+| nosdn | 18/18 | 100% | `fuel-arm-res-128`_ |
++---------------------+---------+---------+----------------------+
+| odl_l2 | 21/21 | 100% | `fuel-arm-res-122`_ |
++---------------------+---------+---------+----------------------+
+| odl_l2-noha | 18/18 | 100% | `fuel-arm-res-129`_ |
++---------------------+---------+---------+----------------------+
+| odl_l3 | 17/18 | 95% | `fuel-arm-res-135`_ |
++---------------------+---------+---------+----------------------+
+
+
+Joid
+----
+
++---------------------+---------+---------+-----------------+
+| Scenario | Scoring | Success | Results |
+| | | rate | |
++=====================+=========+=========+=================+
+| nosdn | 18/18 | 100% | `joid-res-102`_ |
++---------------------+---------+---------+-----------------+
+| nosdn-noha | 17/18 | 95% | `joid-res-93`_ |
++---------------------+---------+---------+-----------------+
+| nosdn-lxd | 12/12 | 100% | `joid-res-104`_ |
++---------------------+---------+---------+-----------------+
+| nosdn-lxd-noha | 12/12 | 100% | `joid-res-91`_ |
++---------------------+---------+---------+-----------------+
+| odl_l2 | 21/21 | 100% | `joid-res-103`_ |
++---------------------+---------+---------+-----------------+
+| onos | 21/21 | 100% | `joid-res-345`_ |
++---------------------+---------+---------+-----------------+
+| onos-sfc | 24/24 | 100% | `joid-res-97`_ |
++---------------------+---------+---------+-----------------+
+
+It is highly recommended to install a json viewer in your browser
+(e.g. https://addons.mozilla.org/fr/firefox/addon/jsonview/)
+
+You can get additional details through test logs on http://artifacts.opnfv.org/.
+As no search engine is available on the OPNFV artifact web site you must
+retrieve the pod identifier on which the tests have been executed (see
+field pod in any of the results) then click on the selected POD and look
+for the date of the test you are interested in.
+
+The reporting pages can be found at:
+
+ * apex: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-apex.html
+ * compass: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-compass.html
+ * fuel: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-fuel.html
+ * joid: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-joid.html
+
+Colorado known restrictions/issues
+==================================
+
++-----------+-----------+----------------------------------------------+
+| Installer | Scenario | Issue |
++===========+===========+==============================================+
+| any | odl_l3-* | Tempest cases related to using floating IP |
+| | | addresses fail because of a known ODL bug. |
+| | | vPing_ssh test case is excluded for the same |
+| | | reason. |
+| | | https://jira.opnfv.org/browse/APEX-112 |
+| | | https://jira.opnfv.org/browse/FUNCTEST-445 |
++-----------+-----------+----------------------------------------------+
+| apex/fuel | *-bgpvpn | vPing_ssh (floating ips not supported) and |
+| | | vIMS excluded. Some Tempest cases related to |
+| | | floating ips also excluded. Some performance |
+| | | issues have been detected in this scenario |
+| | | (i.e. BGPVPN extension enabled) when running |
+| | | commands against the OpenStack APIs, thus |
+| | | Rally sanity test case has been disabled. |
+| | | Performance issues seem to be connected to |
+| | | the ODL version. It is planned to reintroduce|
+| | | Rally sanity in Colorado 2.0 with the |
+| | | adoption of ODL Boron release. |
++-----------+-----------+----------------------------------------------+
+| apex | *-fdio | Due to late integration, fdio decided to |
+| | | focus on mandatory tests and exclude feature |
+| | | tests (copper, doctor, security_scan) from |
+| | | its scenarios |
++-----------+-----------+----------------------------------------------+
+| compass | moon | First ODL test FAILS because ODL/Openstack |
+| | | federation done in moon is partial. Only |
+| | | MD-SAL is federated (not AD-SAL) |
++-----------+-----------+----------------------------------------------+
+| fuel | any | TestServerBasicOps test case skipped |
+| | | https://gerrit.opnfv.org/gerrit/#/c/19635/ |
++-----------+-----------+----------------------------------------------+
+| fuel | kvm | vPing_ssh and vIMS excluded (metadata related|
+| | | scenarios) |
++-----------+-----------+----------------------------------------------+
+| fuel | multisite | random errors running multisite. A known bug |
+| | | in keystone mitaka, due to which memcache |
+| | | raises exception and keystone becomes |
+| | | unresponsive |
+| | | bugs.launchpad.net/keystone/+bug/1600394 |
+| | | workaround consists in restarting memcache on|
+| | | server |
++-----------+-----------+----------------------------------------------+
+| joid | any | Tempest cases related to object storage |
+| | | excluded |
+| | | https://gerrit.opnfv.org/gerrit/#/c/17871/ |
++-----------+-----------+----------------------------------------------+
+| joid | domino | Domino tests are skipped in CI. However the |
+| | | test case can be run by manually setting |
+| | | IS_IPandKEY_CONFIGURED=true after manually |
+| | | setting properly the IP addresses of the 3 |
+| | | Controller nodes in the configuration file |
+| | | /repos/domino/tests/run_multinode.sh |
++-----------+-----------+----------------------------------------------+
+
+
+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. The scenario dependencies (installer or scenario) are detailed
+in https://git.opnfv.org/cgit/functest/tree/ci/testcases.yaml
+
+Test results
+============
+
+Test results are available in:
+
+ - test results document: http://artifacts.opnfv.org/functest
+
+ - jenkins logs on CI: https://build.opnfv.org/ci/view/functest/
+
+ - jenkins logs on ARM CI: https://build.opnfv.org/ci/view/armband/
+
+
+
+Open JIRA tickets
+=================
+
++------------------+-----------------------------------------------+
+| JIRA | Description |
++==================+===============================================+
+| `FUNCTEST-446`_ | Cleanup ODL-SFC output in Functest execution |
+| | Impact on odl_l2-sfc scenarios |
++------------------+-----------------------------------------------+
+| `FUNCTEST-454`_ | Cleanup failures when using HA networks in |
+| | Neutron |
++------------------+-----------------------------------------------+
+
+Useful links
+============
+
+ - wiki project page: https://wiki.opnfv.org/opnfv_functional_testing
+
+ - wiki Functest Colorado page: https://wiki.opnfv.org/display/functest/Functest+Colorado
+
+ - 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
+
+ - Functest IRC chan: #opnfv-functest
+
+ - Functest reporting: http://testresults.opnfv.org/reporting
+
+ - Functest test configuration: https://git.opnfv.org/cgit/functest/tree/ci/testcases.yaml
+
+ - Functest Colorado user guide: http://artifacts.opnfv.org/functest/colorado/docs/userguide/index.html
+
+ - Functest installation/configuration guide: http://artifacts.opnfv.org/functest/colorado/docs/configguide/index.html
+
+ - Functest developer guide: http://artifacts.opnfv.org/functest/colorado/docs/devguide/index.html
+
+.. _`FUNCTEST-446` : https://jira.opnfv.org/browse/FUNCTEST-446
+
+.. _`FUNCTEST-454` : https://jira.opnfv.org/browse/FUNCTEST-454
+
+.. _`apex-res-6` : http://testresults.opnfv.org/test/api/v1/results?build_tag=bd-push-daily-colorado-6
+
+.. _`apex-res-174` : http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-174
+
+.. _`apex-res-175`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-175
+
+.. _`apex-res-176`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-176
+
+.. _`apex-res-217`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-217
+
+.. _`apex-res-235`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-235
+
+.. _`apex-res-423`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-apex-apex-daily-colorado-daily-colorado-423
+
+.. _`compass-res-55`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-55
+
+.. _`compass-res-59`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-59
+
+.. _`compass-res-73`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-73
+
+.. _`compass-res-76`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-76
+
+.. _`compass-res-77`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-colorado-77
+
+.. _`compass-res-567`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-master-567
+
+.. _`compass-res-285`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-compass-virtual-daily-master-285
+
+.. _`fuel-res-8`: https://build.opnfv.org/ci/view/functest/job/functest-fuel-virtual-suite-colorado/lastSuccessfulBuild/console
+
+.. _`fuel-res-115`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-115
+
+.. _`fuel-res-117`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-117
+
+.. _`fuel-res-119`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-119
+
+.. _`fuel-res-123`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-123
+
+.. _`fuel-res-124`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-124
+
+.. _`fuel-res-128`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-128
+
+.. _`fuel-res-129`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-baremetal-daily-colorado-129
+
+.. _`fuel-res-154`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-154
+
+.. _`fuel-res-155`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-155
+
+.. _`fuel-res-160`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-160
+
+.. _`fuel-res-161`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-161
+
+.. _`fuel-res-162`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-162
+
+.. _`fuel-res-164`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-164
+
+.. _`fuel-res-166`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-166
+
+.. _`fuel-res-213`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-213
+
+.. _`fuel-res-219`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-219
+
+.. _`fuel-res-376`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-376
+
+.. _`fuel-res-492`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-fuel-virtual-daily-colorado-492
+
+.. _`fuel-arm-res-128`: https://build.opnfv.org/ci/view/armband/job/functest-fuel-armband-baremetal-daily-colorado/128/console
+
+.. _`fuel-arm-res-122`: https://build.opnfv.org/ci/view/armband/job/functest-fuel-armband-baremetal-daily-colorado/122/console
+
+.. _`fuel-arm-res-129`: https://build.opnfv.org/ci/view/armband/job/functest-fuel-armband-baremetal-daily-colorado/129/console
+
+.. _`fuel-arm-res-135`: https://build.opnfv.org/ci/view/armband/job/functest-fuel-armband-baremetal-daily-colorado/135/console
+
+.. _`joid-res-93`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-93
+
+.. _`joid-res-91`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-91
+
+.. _`joid-res-99`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-99
+
+.. _`joid-res-97`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-97
+
+.. _`joid-res-102`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-102
+
+.. _`joid-res-103`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-103
+
+.. _`joid-res-104`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-104
+
+.. _`joid-res-345`: http://testresults.opnfv.org/test/api/v1/results?build_tag=jenkins-functest-joid-baremetal-daily-colorado-345
+
diff --git a/docs/release/release-notes/index.rst b/docs/release/release-notes/index.rst
new file mode 100644
index 000000000..6c6d18109
--- /dev/null
+++ b/docs/release/release-notes/index.rst
@@ -0,0 +1,15 @@
+**********************
+Functest Release Notes
+**********************
+
+.. toctree::
+ :numbered:
+ :maxdepth: 4
+
+ functest-release.rst
+
+Revision: _sha1_
+
+:Author: Morgan Richomme (morgan.richomme@orange.com)
+
+Build date: |today|