X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=fuel%2Fdocs%2Fsrc%2Frelease-notes.rst;h=220e80b8ade07d0d12ca74093f02625ff540c796;hb=refs%2Fchanges%2F51%2F751%2F3;hp=221b7f78ee260a350626d5a51eceb4b4cf732b09;hpb=4266577cd0a7c0816cd3bf951522c7ad1633f02b;p=genesis.git diff --git a/fuel/docs/src/release-notes.rst b/fuel/docs/src/release-notes.rst index 221b7f7..220e80b 100644 --- a/fuel/docs/src/release-notes.rst +++ b/fuel/docs/src/release-notes.rst @@ -1,131 +1,116 @@ -:Authors: Jonas Bjurel (Ericsson) -:Version: 0.2 +===================================================================================== +OPNFV Release Note for the Arno release of OPNFV when using Fuel as a deployment tool +===================================================================================== + + +.. contents:: Table of Contents + :backlinks: none -================================================================ -OPNFV Release Note for "Arno-RC2 release candidate" - Fuel@OPNFV -================================================================ Abstract ======== -This document provides the release notes for ARNO-RC2 release candidate of Fuel@OPNFV. +This document compiles the release notes for the Arno release of OPNFV when using Fuel as a deployment tool. License ======= -Fuel@OPNFV DOCs (c) by Jonas Bjurel (Ericsson AB) - -Fuel@OPNFV 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 . - - -**Contents** - -1 Version History - -2 Important notes -3 Summary +Arno release with the Fuel deployment tool Docs (c) by Jonas Bjurel (Ericsson AB) -4 Delivery Data +Arno release with the Fuel deployment tool 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 . -5 Known Limitations, Issues and Workarounds - -6 Test Result - -7 References - -1 Version history -=================== +Version history +=============== +--------------------+--------------------+--------------------+--------------------+ | **Date** | **Ver.** | **Author** | **Comment** | | | | | | +--------------------+--------------------+--------------------+--------------------+ -| 2015-04-16 | 0.1 | Jonas Bjurel | First draft | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ -| 2015-04-23 | 0.2 | Jonas Bjurel | Minor change | +| 2015-06-03 | 1.0.0 | Jonas Bjurel | Arno SR0 release | | | | | | +--------------------+--------------------+--------------------+--------------------+ -2 Important notes -=================== +Important notes +=============== -This is the first OPNFV Arno pre-release that implements the deploy stage of the OPNFV CI pipeline. +For the first OPNFV release (Arno), these notes introduce use of `OpenStack Fuel ` for the deployment stage of the OPNFV continuous integration (CI) pipeline. The goal of the Arno release and this Fuel-based deployment process is to establish a foundational platform accelerating further development of the OPNFV infrastructure. -Carefully follow the installation-instructions and pay special attention to the pre-deploy script that needs to be ran befor deployment is started. +Carefully follow the installation-instructions and pay special attention to the pre-deploy script that needs to be run before deployment is started. -3 Summary -=========== +Summary +======= -Arno Fuel@OPNFV is based the OpenStack Fuel upstream project version 6.0.1, but adds OPNFV unique components such as OpenDaylight version: Helium as well as other OPNFV unique configurations. +For Arno, the typical use of Fuel as an OpenStack installer is supplemented with OPNFV unique components such as `OpenDaylight `_ version Helium as well as OPNFV-unique configurations. -This Arno pre-release of Fuel@OPNFV adds the deploy stage of the OPNFV CI pipeline +This Arno artefact provides Fuel as the deployment stage tool in the OPNFV CI pipeline including: -- Documentation is built by Jenkins -- .iso image is built by Jenkins -- Jenkins deploy an Fuel@OPNFV stack instance on a nested hypervisor environment (KVM) +- Documentation built by Jenkins + - this document (release notes) + - installation instructions + - build-instructions +- The Arno Fuel installer image (.iso) built by Jenkins +- Automated deployment of Arno with running on bare metal or a nested hypervisor environment (KVM) +- Automated validation of the Arno deployment -Automatic test of the deployed system is not part of this pre-release. -4 Release Data -================ +Release Data +============ +--------------------------------------+--------------------------------------+ -| **Project** | Arno/genesis/fuel | +| **Project** | genesis/bgs | | | | +--------------------------------------+--------------------------------------+ -| **Repo/tag** | genesis/arno-rc2 | +| **Repo/tag** | genesis/arno.2015.1.0 | | | | +--------------------------------------+--------------------------------------+ -| **Release designation** | Arno RC2 | +| **Release designation** | Arno Base Service release 0 (SR0) | | | | +--------------------------------------+--------------------------------------+ -| **Release date** | 2015-04-16 | +| **Release date** | 2015-06-04 | | | | +--------------------------------------+--------------------------------------+ -| **Purpose of the delivery** | OPNFV Internal quality assurance | -| | and CI Pipline dry-run | +| **Purpose of the delivery** | OPNFV Arno Base SR0 release | | | | +--------------------------------------+--------------------------------------+ -4.1 Version change ------------------- - -4.1.1 Module version changes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the first tracked version of genesis/fuel. It is based on following upstream versions: +Version change +-------------- -- Fuel 6.0.1 (Juno release) +Module version changes +~~~~~~~~~~~~~~~~~~~~~~ +This is the first tracked release of genesis/fuel. It is based on following upstream versions: -- OpenDaylight Helium-SR2 +- Fuel 6.0.1 +- OpenStack Juno release +- OpenDaylight Helium-SR3 -- Ubuntu 12.04.5 +Document version changes +~~~~~~~~~~~~~~~~~~~~~~~~ +This is the first tracked version of the fuel installer for OPNFV. It comes with the following documentation: -4.1.2 Document version changes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the first tracked version of genesis/fuel. It comes with the following documentation: +- OPNFV Installation instructions for Arno with Fuel as deployment tool +- OPNFV Release Notes for Arno use of Fuel as deployment tool +- OPNFV Build instructions for Arno with Fuel as deployment tool -- OPNFV Installation instructions for - Fuel@OPNFV - ver. 0.0.1 -- OPNFV Release Note for "Arno-RC2 release candidate" - Fuel@OPNFV - ver. 0.1 (this document) -4.2 Reason for version ----------------------- -4.2.1 Feature additions -~~~~~~~~~~~~~~~~~~~~~~~ +Reason for version +------------------ +Feature additions +~~~~~~~~~~~~~~~~~ +--------------------------------------+--------------------------------------+ | **JIRA REFERENCE** | **SLOGAN** | | | | +--------------------------------------+--------------------------------------+ -| JIRA: | Baselining Fuel 6.0.1 for OPNFV | +| JIRA:- | Baselining Fuel 6.0.1 for OPNFV | | | | +--------------------------------------+--------------------------------------+ -| JIRA: | Integration of OpenDaylight | +| JIRA:- | Integration of OpenDaylight | | | | +--------------------------------------+--------------------------------------+ -4.2.2 Bug corrections -~~~~~~~~~~~~~~~~~~~~~ +Bug corrections +~~~~~~~~~~~~~~~ **JIRA TICKETS:** @@ -134,26 +119,27 @@ This is the first tracked version of genesis/fuel. It comes with the following d | | | +--------------------------------------+--------------------------------------+ | | | -| | | +| - | - | +--------------------------------------+--------------------------------------+ -4.3 Deliverables ----------------- +Deliverables +------------ -4.3.1 Software deliverables -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Fuel@OPNFV .iso file +Software deliverables +~~~~~~~~~~~~~~~~~~~~~ +Fuel-based installer iso file -4.3.2 Documentation deliverables -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- OPNFV Installation instructions for - Fuel@OPNFV - ver. 0.0.1 -- OPNFV Release Note for "Arno-RC2 release candidate" - Fuel@OPNFV - ver. 0.1 (this document) +Documentation deliverables +~~~~~~~~~~~~~~~~~~~~~~~~~~ +- OPNFV Installation instructions for Arno release with the Fuel deployment tool - ver. 1.0.0 +- OPNFV Build instructions for Arno release with the Fuel deployment tool - ver. 1.0.0 +- OPNFV Release Note for Arno release with the Fuel deployment tool - ver. 1.0.0 (this document) -5 Known Limitations, Issues and Workarounds -============================================ +Known Limitations, Issues and Workarounds +========================================= -5.1 System Limitations -------------------------- +System Limitations +------------------ **Max number of blades:** 1 Fuel master, 3 Controllers, 20 Compute blades @@ -163,10 +149,9 @@ Fuel@OPNFV .iso file **Max number of networks:** 3800 (Needs special switch config.) -**L3Agent:** L3 agent and floating IPs is not supported. -5.2 Known issues -------------------- +Known issues +------------ **JIRA TICKETS:** @@ -174,31 +159,66 @@ Fuel@OPNFV .iso file | **JIRA REFERENCE** | **SLOGAN** | | | | +--------------------------------------+--------------------------------------+ -| JIRA: | CentOS is not supported | +| JIRA: BGS-57 | The OpenDaylight Helium release is | +| | not fully functional and the | +| | resulting Fuel integration is not | +| | able to cope with the deficiancies. | +| | It is therefore not recommended to | +| | to enable this option. | +| | A functional integration of ODL | +| | version: Lithium is expected to be | +| | available in an upcomming service | +| | release. | | | | +--------------------------------------+--------------------------------------+ -5.3 Workarounds ------------------- -**-** +Workarounds +----------- +Current workaround for the JIRA: BGS-57 is not to enable OpenDaylight networking - see installation instructions. -6 Test Result -============== +Test Result +=========== -Fuel@OPNFV Arno RC2 has undergone QA test runs with the following results: +Arno release with the Fuel deployment tool has undergone QA test runs with the following results: +--------------------------------------+--------------------------------------+ | **TEST-SUITE** | **Results:** | | | | +--------------------------------------+--------------------------------------+ -| **-** | **-** | +| Tempest test suite 1: | 27 out of 105 testcases fails | +| | see note (1) and note (2) | +--------------------------------------+--------------------------------------+ +| Tempest test suite 2: | 26 out of 100 testcases fails | +| | see note (1) and note (2) | ++--------------------------------------+--------------------------------------+ +| Tempest test suite 3: | 14 out of 106 testcases fails | +| | see note (1) and note (2) | ++--------------------------------------+--------------------------------------+ +| Rally test suite suie 1: | 10 out of 18 testcases fails | +| | see note (1) and note (3) | ++--------------------------------------+--------------------------------------+ +| ODL test suite suie | 7 out of 7 testcases fails | +| | see note (1) and note (4) | ++--------------------------------------+--------------------------------------+ +| vPING | OK | +| | see note (1) | ++--------------------------------------+--------------------------------------+ + +** - Note (1): Have been run with ODL controller active but not with integrated ODL networking VXLAN segmentation activated ** +** - Note (2): see https://wiki.opnfv.org/r1_tempest ** +** - Note (3): see https://wiki.opnfv.org/r1_rally_bench ** +** - Note (4): see https://wiki.opnfv.org/r1_odl_suite ** +References +========== +For more information on the OPNFV Arno release, please see http://wiki.opnfv.org/releases/arno. + +:Authors: Jonas Bjurel (Ericsson) +:Version: 1.0.0 -7 References -============= +**Documentation tracking** -For more information on the OPNFV Arno release, please see: +Revision: _sha1_ -http://wiki.opnfv.org/release/arno +Build date: _date_