-==========================================================================
-OPNFV Release Notes for the Colorado release of OPNFV Apex deployment tool
-==========================================================================
+==============================================================================
+OPNFV Release Notes for the Colorado 3.0 release of OPNFV Apex deployment tool
+==============================================================================
.. contents:: Table of Contents
Abstract
========
-This document provides the release notes for Colorado release with the Apex
+This document provides the release notes for Colorado 3.0 release with the Apex
deployment toolchain.
License
| **Date** | **Ver.** | **Authors** | **Comment** |
| | | | |
+-------------+-----------+-----------------+----------------------+
+| 2016-12-05 | 2.3.0 | Tim Rozet | More updates for |
+| | | | Colorado 3.0 |
++-------------+-----------+-----------------+----------------------+
+| 2016-10-26 | 2.2.0 | Tim Rozet | More updates for |
+| | | | Colorado 2.0 |
++-------------+-----------+-----------------+----------------------+
| 2016-09-20 | 2.1.0 | Tim Rozet | More updates for |
| | | | Colorado |
+-------------+-----------+-----------------+----------------------+
Important Notes
===============
-This is the OPNFV Colorado release that implements the deploy stage of the
+This is the OPNFV Colorado 3.0 release that implements the deploy stage of the
OPNFV CI pipeline via Apex.
Apex is based on RDO's Triple-O installation tool chain.
| **Project** | apex |
| | |
+--------------------------------------+--------------------------------------+
-| **Repo/tag** | apex/colorado.1.0 |
+| **Repo/tag** | apex/colorado.3.0 |
| | |
+--------------------------------------+--------------------------------------+
-| **Release designation** | colorado.1.0 |
+| **Release designation** | colorado.3.0 |
| | |
+--------------------------------------+--------------------------------------+
-| **Release date** | 2016-09-22 |
+| **Release date** | 2016-12-5 |
| | |
+--------------------------------------+--------------------------------------+
-| **Purpose of the delivery** | OPNFV Colorado release |
+| **Purpose of the delivery** | OPNFV Colorado 3.0 release |
| | |
+--------------------------------------+--------------------------------------+
Module version changes
~~~~~~~~~~~~~~~~~~~~~~
-This is the first tracked version of the Colorado release with the Apex
+This is the second tracked version of the Colorado release with the Apex
deployment toolchain. It is based on following upstream versions:
- OpenStack (Mitaka release)
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
+ deployment toolchain - ver. 3.0
- OPNFV Release Notes for the Colorado release with the Apex deployment
- toolchain - ver. 1.0.0 (this document)
+ toolchain - ver. 2.3.0 (this document)
Feature Additions
~~~~~~~~~~~~~~~~~
+--------------------------------------+--------------------------------------+
| JIRA: APEX-153 | brbm bridge not created in jumphost |
+--------------------------------------+--------------------------------------+
+| JIRA: APEX-274 | OVS DPDK scenario does not create |
+| | vhost user ports |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-277 | ONOS fails to launch due to OVS and |
+| | Kernel version mismatch |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-179 | DNS settings not working properly |
+| | for baremetal deployments |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-203 | Swift proxy enabled and fails in noha|
+| | deployment |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-230 | Tacker heat_uri setting is wrong |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-241 | Glance services are not running after|
+| | reboot |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-265 | Metadata problems with os-odl_l2-sfc |
+| | scenario |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-271 | L3 agent interface_driver set |
+| | incorrectly for nosdn fdio noha |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-275 | Metadata fails in ODL Boron |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-278 | Duplicate neutron config class |
+| | declaration for SDNVPN |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-281 | ONOS sometimes fails to provide |
+| | addresses to instances |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-283 | Change networking-vpp ML2 driver to |
+| | etcd |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-284 | vpp and hc versions for os-odl_l2 |
+| | -fdio-noha scenario |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-285 | Remove vlan-strip-offload off config |
+| | from os-odl_l2-fdio-noha scenario |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-286 | Make fdio repo an option in puppet- |
+| | fdio |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-289 | Set undercloud VM to autostart for |
+| | reboot |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-291 | link to apex installer missing on |
+| | OPNFV download site |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-293 | tenant_nic is assumed to be a virtual|
+| | name for nosdn fdio scenario |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-294 | dns server settings is ignored from |
+| | network_settings.yaml |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-297 | Add details in "11.2 Creating a Node |
+| | Inventory File" |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-326 | Consolidate SFC rpm into regular Apex|
+| | rpm |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-331 | Conditionally install OVS NSH in |
+| | ONOS Deployment |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-332 | IPv6 Scenario fails to deploy |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-333 | OVS DPDK does not work with UCS |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-334 | ONOS SFC not using SFC version of OVS|
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-335 | Performance settings missing in |
+| | os-odl_l2-fdio-ha.yaml |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-163 | Prefix to mask calculation doesn't |
+| | work |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-266 | ntp server shoudl be in network |
+| | settings |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-292 | unclear that ip ranges in network |
+| | settings may not overlap |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-349 | puppet-keystone failures in Colorado |
+| | errors deplyoment |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-344 | Update vpp/hc from 16.09 to 17.01 |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-346 | Update ODL to Carbon for FDIO |
+| | scenario |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-347 | Add deploy setting for ceph_device |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-341 | FDIO scenarios: not supplying |
+| | main-core and core-list workers |
+| | causes deploy failure |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-343 | Update qemu for fdio scenarios |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-344 | nosdn fdio scenario missing iommu |
+| | kernel params |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-337 | enable isolcpu on kernel and pin vpp |
+| | to the unused CPU for FDIO scenarios |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-338 | Install Procedure for baremetal |
+| | updated |
++--------------------------------------+--------------------------------------+
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 overcloud ODL SFC .rpm (opnfv-apex-opendaylight-sfc) - ODL SFC Scenario
- Apex undercloud .rpm (opnfv-apex-undercloud)
- Apex common .rpm (opnfv-apex-common)
- build.sh - Builds the above artifacts
Documentation Deliverables
~~~~~~~~~~~~~~~~~~~~~~~~~~
- OPNFV Installation instructions for the Colorado release with the Apex
- deployment toolchain - ver. 1.0.0
+ deployment toolchain - ver. 3.0
- OPNFV Release Notes for the Colorado release with the Apex deployment
- toolchain - ver. 1.0.0 (this document)
+ toolchain - ver. 2.2.0 (this document)
Known Limitations, Issues and Workarounds
=========================================
| **JIRA REFERENCE** | **SLOGAN** |
| | |
+--------------------------------------+--------------------------------------+
-| JIRA: APEX-203 | Swift proxy enabled and fails in noha|
-| | deployments |
+| JIRA: APEX-112 | ODL route local subnet traffic to GW |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-149 | OpenFlow rules are populated slowly |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-268 | VMs with multiple floating IPs can |
+| | only access first NIC |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-270 | Glance v2 api does not support url |
+| | images |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-272 | Enable VLAN tenant networking and |
+| | ability to configure range |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-280 | Deleted network not cleaned up on |
+| | controller |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-290 | Instances cannot connect to metadata |
+| | service after cluster reboot |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-295 | VLAN tenant networking does not work |
+| | in OVS DPDK scenario |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-339 | OVS DPDK PMD is not CPU pinned |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-355 | Undercloud CPU, RAM, Disk cannot be |
+| | adjusted |
++--------------------------------------+--------------------------------------+
+| JIRA: APEX-345 | Dashboard links time-out due to |
+| | running out of file descriptors for |
+| | mariadb |
+--------------------------------------+--------------------------------------+
| JIRA: APEX-215 | Keystone services not configured and |
| | the error is silently ignored (VLAN |
* `APEX-149 <https://jira.opnfv.org/browse/APEX-149>`_:
Openflow rules are populated very slowly
+Scenario os-odl_l2-bgpvpn known issues
+--------------------------------------
+
+None
+
+Scenario os-onos-nofeature known issues
+---------------------------------------
+
+None
+
+Scenario 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
+None
Scenario os-nosdn-ovs known issues
----------------------------------
-* `APEX-274 <https://jira.opnfv.org/browse/APEX-274>`_:
- OVS DPDK scenario does not create vhost user ports
+None
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-121 <https://jira.opnfv.org/browse/FDS-121>`_:
+ qemu doesn't receive connection on socket, vhost-user reconnect problem
* `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
+* `APEX-337 <https://jira.opnfv.org/browse/APEX-337>`_:
+ enable isolcpu on kernel and pin vpp to unused cpu for fdio scenarios
+
+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:
===========
The Colorado release with the Apex deployment toolchain has undergone QA
-test runs with the following results:
-
-+--------------------------------------+--------------------------------------+
-| **TEST-SUITE** | **Results:** |
-| | |
-+--------------------------------------+--------------------------------------+
-| **-** | **-** |
-+--------------------------------------+--------------------------------------+
+test runs with the OPNFV FuncTest project. The latest results per scenario
+can be found `here <http://testresults.opnfv.org/reporting/functest/
+release/colorado/index-status-apex.html>`_ for Colorado release.
References
:Authors: Tim Rozet (trozet@redhat.com)
:Authors: Dan Radez (dradez@redhat.com)
-:Version: 2.1.0
+:Version: 2.3.0