diff options
author | Sofia Wallin <sofia.wallin@ericsson.com> | 2017-02-17 14:00:36 +0100 |
---|---|---|
committer | Sofia Wallin <sofia.wallin@ericsson.com> | 2017-02-17 14:00:36 +0100 |
commit | 4bdb2d6a128664082bddad51091e0d9fb63068fd (patch) | |
tree | 7063348d03a3c6464226ca7fffd85f41e52042a5 /docs/releasenotes | |
parent | 5e4c2ffc86d0426113f60b8069e81482f82bbc8d (diff) |
Doc updates for MS6
Updated the docs structure according to directives and MS6
Change-Id: I36e92cbc58328528ebb91ff4f54ee701f5477443
Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
Diffstat (limited to 'docs/releasenotes')
-rw-r--r-- | docs/releasenotes/index.rst | 11 | ||||
-rw-r--r-- | docs/releasenotes/release-notes.rst | 411 |
2 files changed, 0 insertions, 422 deletions
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst deleted file mode 100644 index 1f723960..00000000 --- a/docs/releasenotes/index.rst +++ /dev/null @@ -1,11 +0,0 @@ -************************ -OPNFV Apex Release Notes -************************ - -Contents: - -.. toctree:: - :numbered: - :maxdepth: 4 - - release-notes.rst diff --git a/docs/releasenotes/release-notes.rst b/docs/releasenotes/release-notes.rst deleted file mode 100644 index a5d52f0c..00000000 --- a/docs/releasenotes/release-notes.rst +++ /dev/null @@ -1,411 +0,0 @@ -========================================================================== -OPNFV Release Notes for the Colorado release of OPNFV Apex deployment tool -========================================================================== - - -.. contents:: Table of Contents - :backlinks: none - - -Abstract -======== - -This document provides the release notes for Colorado release with the Apex -deployment toolchain. - -License -======= - -All Apex and "common" entities are protected by the Apache License -( http://www.apache.org/licenses/ ) - - -Version History -=============== - - -+-------------+-----------+-----------------+----------------------+ -| **Date** | **Ver.** | **Authors** | **Comment** | -| | | | | -+-------------+-----------+-----------------+----------------------+ -| 2016-09-20 | 2.1.0 | Tim Rozet | More updates for | -| | | | Colorado | -+-------------+-----------+-----------------+----------------------+ -| 2016-08-11 | 2.0.0 | Dan Radez | Updates for Colorado | -+-------------+-----------+-----------------+----------------------+ -| 2015-09-17 | 1.0.0 | Dan Radez | Rewritten for | -| | | | RDO Manager update | -+-------------+-----------+-----------------+----------------------+ - -Important Notes -=============== - -This is the OPNFV Colorado release that implements the deploy stage of the -OPNFV CI pipeline via Apex. - -Apex is based on RDO's Triple-O installation tool chain. -More information at http://rdoproject.org - -Carefully follow the installation-instructions which guide a user on how to -deploy OPNFV using Apex installer. - -Summary -======= - -Colorado release with the Apex deployment toolchain will establish an OPNFV -target system on a Pharos compliant lab infrastructure. The current definition -of an OPNFV target system is OpenStack Mitaka combined with an SDN -controller, such as OpenDaylight. The system is deployed with OpenStack High -Availability (HA) for most OpenStack services. SDN controllers are deployed -only on the first controller (see HAIssues_ for known HA SDN issues). Ceph -storage is used as Cinder backend, and is the only supported storage for -Colorado. Ceph is setup as 3 OSDs and 3 Monitors, one OSD+Mon per Controller -node in an HA setup. Apex also supports non-HA deployments, which deploys a -single controller and n number of compute nodes. Furthermore, Apex is -capable of deploying scenarios in a bare metal or virtual fashion. Virtual -deployments use multiple VMs on the jump host and internal networking to -simulate the a bare metal deployment. - -- Documentation is built by Jenkins -- .iso image is built by Jenkins -- .rpm packages are built by Jenkins -- Jenkins deploys a Colorado release with the Apex deployment toolchain - bare metal, which includes 3 control+network nodes, and 2 compute nodes. - -Release Data -============ - -+--------------------------------------+--------------------------------------+ -| **Project** | apex | -| | | -+--------------------------------------+--------------------------------------+ -| **Repo/tag** | apex/colorado.1.0 | -| | | -+--------------------------------------+--------------------------------------+ -| **Release designation** | colorado.1.0 | -| | | -+--------------------------------------+--------------------------------------+ -| **Release date** | 2016-09-22 | -| | | -+--------------------------------------+--------------------------------------+ -| **Purpose of the delivery** | OPNFV Colorado release | -| | | -+--------------------------------------+--------------------------------------+ - -Version change --------------- - -Module version changes -~~~~~~~~~~~~~~~~~~~~~~ -This is the first tracked version of the Colorado release with the Apex -deployment toolchain. It is based on following upstream versions: - -- OpenStack (Mitaka release) - -- OpenDaylight (Beryllium/Boron releases) - -- CentOS 7 - -Document Version Changes -~~~~~~~~~~~~~~~~~~~~~~~~ - -This is the first tracked version of Colorado release with the Apex -deployment toolchain. -The following documentation is provided with this release: - -- OPNFV Installation instructions for the Colorado release with the Apex - deployment toolchain - ver. 1.0.0 -- OPNFV Release Notes for the Colorado release with the Apex deployment - toolchain - ver. 1.0.0 (this document) - -Feature Additions -~~~~~~~~~~~~~~~~~ - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-107 | OpenDaylight HA - OVSDB Clustering | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-108 | Migrate to OpenStack Mitaka | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-30 | Support VLAN tagged deployments | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-105 | Enable Huge Page Configuration | -| | Options | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-111 | Allow RAM to be specified for | -| | Control/Compute in Virtual | -| | Deployments | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-119 | Enable OVS DPDK as a deployment | -| | Scenario in Apex | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-126 | Tacker Service deployed by Apex | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-135 | Congress Service deployed by Apex | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-127 | Nova Instance CPU Pinning | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-130 | IPv6 Underlay Deployment | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-133 | FDIO with Honeycomb Agent | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-141 | Integrate VSPERF into Apex | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-172 | Enable ONOS SFC | -+--------------------------------------+--------------------------------------+ - -Bug Corrections -~~~~~~~~~~~~~~~ - -**JIRA TICKETS:** - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-86 | Need ability to specify number of | -| | compute nodes | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-180 | Baremetal deployment error: Failed to| -| | mount root partition /dev/sda on | -| | /mnt/rootfs | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-161 | Heat autoscaling stack creation fails| -| | for non-admin users | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-198 | Missing NAT iptables rule for public | -| | network in instack VM | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-147 | Installer doesn't generate/distribute| -| | SSH keys between compute nodes | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-109 | ONOS routes local subnet traffic to | -| | GW | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-146 | Swift service present in available | -| | endpoints | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-160 | Enable force_metadata to support | -| | subnets with VM as the router | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-114 | OpenDaylight GUI is not available | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-100 | DNS1 and DNS2 should be handled in | -| | nic bridging | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-100 | DNS1 and DNS2 should be handled in | -| | nic bridging | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-155 | NIC Metric value not used when | -| | bridging NICs | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-136 | 2 network deployment fails | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-89 | Deploy Ceph OSDs on compute nodes | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-137 | added arping ass dependency for | -| | ONOS deployments | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-121 | VM Storage deletion intermittently | -| | fails | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-182 | Nova services not correctly deployed | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-153 | brbm bridge not created in jumphost | -+--------------------------------------+--------------------------------------+ - -Deliverables ------------- - -Software Deliverables -~~~~~~~~~~~~~~~~~~~~~ -- Apex .iso file -- Apex release .rpm (opnfv-apex-release) -- Apex overcloud .rpm (opnfv-apex) - For nosdn and OpenDaylight Scenarios -- Apex overcloud onos .rpm (opnfv-apex-onos) - ONOS Scenarios -- Apex undercloud .rpm (opnfv-apex-undercloud) -- Apex common .rpm (opnfv-apex-common) -- build.sh - Builds the above artifacts -- opnfv-deploy - Automatically deploys Target OPNFV System -- opnfv-clean - Automatically resets a Target OPNFV Deployment -- opnfv-util - Utility to connect to or debug Overcloud nodes + OpenDaylight - -Documentation Deliverables -~~~~~~~~~~~~~~~~~~~~~~~~~~ -- OPNFV Installation instructions for the Colorado release with the Apex - deployment toolchain - ver. 1.0.0 -- OPNFV Release Notes for the Colorado release with the Apex deployment - toolchain - ver. 1.0.0 (this document) - -Known Limitations, Issues and Workarounds -========================================= - -System Limitations ------------------- - -**Max number of blades:** 1 Apex undercloud, 3 Controllers, 20 Compute blades - -**Min number of blades:** 1 Apex undercloud, 1 Controller, 1 Compute blade - -**Storage:** Ceph is the only supported storage configuration. - -**Min master requirements:** At least 16GB of RAM for baremetal jumphost, -24GB for virtual deployments (noHA). - - -Known Issues ------------- - -**JIRA TICKETS:** - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-203 | Swift proxy enabled and fails in noha| -| | deployments | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-215 | Keystone services not configured and | -| | the error is silently ignored (VLAN | -| | Deployments) | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-208 | Need ability to specify which NIC to | -| | place VLAN on | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-254 | Add dynamic hugepages configuration | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-138 | Unclear error message when interface | -| | set to dhcp | -+--------------------------------------+--------------------------------------+ - - -Workarounds ------------ -**-** - -Scenario specific release notes -=============================== - -Scenario os-odl_l3-nofeature known issues ------------------------------------------ - -* `APEX-112 <https://jira.opnfv.org/browse/APEX-112>`_: - ODL routes local subnet traffic to GW - -Scenario os-odl_l2-nofeature known issues ------------------------------------------ - -* `APEX-149 <https://jira.opnfv.org/browse/APEX-149>`_: - Openflow rules are populated very slowly - -Scenario os-odl-bgpvpn known issues --------------------------------------- - -* `APEX-278 <https://jira.opnfv.org/browse/APEX-278>`_: - Duplicate neutron config class declaration for SDNVPN - -Scenario os-onos-nofeatures/os-onos-sfc known issues ----------------------------------------------------- - -* `APEX-281 <https://jira.opnfv.org/browse/APEX-281>`_: - ONOS sometimes fails to provide addresses to instances - -Scenario os-odl_l2-sfc-noha known issues ----------------------------------------- - -* `APEX-275 <https://jira.opnfv.org/browse/APEX-275>`_: - Metadata fails in Boron - -Scenario os-nosdn-ovs known issues ----------------------------------- - -* `APEX-274 <https://jira.opnfv.org/browse/APEX-274>`_: - OVS DPDK scenario does not create vhost user ports - -Scenario os-odl_l2-fdio-noha known issues ------------------------------------------ - -* `FDS-16 <https://jira.opnfv.org/browse/FDS-16>`_: - Security group configuration through nova leads - to vhostuser port connection issues -* `FDS-62 <https://jira.opnfv.org/browse/FDS-62>`_: - APEX - Increase number of files MariaDB can open -* `FDS-79 <https://jira.opnfv.org/browse/FDS-79>`_: - Sometimes (especially in bulk crete/delete operations - when multiple networks/ports are created within short time) - OpenDaylight doesn't accept creation requests -* `FDS-80 <https://jira.opnfv.org/browse/FDS-80>`_: - After launching a VM it stayed forever in BUILD status. - Also further operation related to this VM (volume attachment etc.) - caused problems -* `FDS-81 <https://jira.opnfv.org/browse/FDS-81>`_: - After functest finishes there are two bds on computes and - none on controller -* `FDS-82 <https://jira.opnfv.org/browse/FDS-82>`_: - Nova list shows no vms but there are some on computes in paused state -* `APEX-217 <https://jira.opnfv.org/browse/APEX-217>`_: - qemu not configured with correct group:user - -Scenario os-nosdn-fdio-noha known issues ----------------------------------------- - -Note that a set of manual configration steps need to be performed -post an automated deployment for the scenario to be fully functional. -Please refer to `FDS-159 <https://jira.opnfv.org/browse/FDS-159>`_ and -`FDS-160 <https://jira.opnfv.org/browse/FDS-160>`_ for details. - -* `FDS-155 <https://jira.opnfv.org/browse/FDS-155>`_: - os-nosdn-fdio-noha scenario: tempest_smoke_serial causes - mariadb/mysqld process to hang -* `FDS-156 <https://jira.opnfv.org/browse/FDS-156>`_: - os-nosdn-fdio-noha scenario: Race conditions for - network-vif-plugged notification -* `FDS-157 <https://jira.opnfv.org/browse/FDS-157>`_: - os-nosdn-fdio-noha scenario: Intermittently VMs - would get assigned 2 IPs instead of 1 -* `FDS-158 <https://jira.opnfv.org/browse/FDS-158>`_: - os-nosdn-fdio-noha scenario: VM start/launch fails with - "no more IP addresses" in neutron logs -* `FDS-159 <https://jira.opnfv.org/browse/FDS-159>`_: - os-nosdn-fdio-noha scenario: Security groups not yet supported -* `FDS-160 <https://jira.opnfv.org/browse/FDS-160>`_: - os-nosdn-fdio-noha scenario: Vlan fix on controller -* `FDS-161 <https://jira.opnfv.org/browse/FDS-161>`_: - os-nosdn-fdio-noha scenario: VPP fails with certain UCS B-series blades - -.. _HAIssues: - -General HA scenario known issues --------------------------------- - -* `COPPER-22 <https://jira.opnfv.org/browse/COPPER-22>`_: - Congress service HA deployment is not yet supported/verified. -* `APEX-276 <https://jira.opnfv.org/browse/APEX-276>`_: - ODL HA unstable and crashes frequently - -Test Result -=========== - -The Colorado release with the Apex deployment toolchain has undergone QA -test runs with the following results: - -+--------------------------------------+--------------------------------------+ -| **TEST-SUITE** | **Results:** | -| | | -+--------------------------------------+--------------------------------------+ -| **-** | **-** | -+--------------------------------------+--------------------------------------+ - - -References -========== - -For more information on the OPNFV Colorado release, please see: - -http://wiki.opnfv.org/releases/Colorado - -:Authors: Tim Rozet (trozet@redhat.com) -:Authors: Dan Radez (dradez@redhat.com) -:Version: 2.1.0 |