From 065fba5bef236f992bd5e4122e635bb21d525af9 Mon Sep 17 00:00:00 2001 From: Brady Johnson Date: Fri, 10 Feb 2017 13:01:52 +0100 Subject: Migrate docs to the new Danube dir structure Change-Id: I6bdfd21add4d04f0fee988f83888c1edcc488951 Signed-off-by: Brady Johnson --- docs/release/release-notes/index.rst | 13 ++ docs/release/release-notes/releasenotes.rst | 204 ++++++++++++++++++++++++++++ 2 files changed, 217 insertions(+) create mode 100644 docs/release/release-notes/index.rst create mode 100644 docs/release/release-notes/releasenotes.rst (limited to 'docs/release/release-notes') diff --git a/docs/release/release-notes/index.rst b/docs/release/release-notes/index.rst new file mode 100644 index 00000000..e5e1dc60 --- /dev/null +++ b/docs/release/release-notes/index.rst @@ -0,0 +1,13 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + .. (c) + +***************** +SFC Release Notes +***************** + +.. toctree:: + :numbered: + :maxdepth: 2 + + releasenotes.rst diff --git a/docs/release/release-notes/releasenotes.rst b/docs/release/release-notes/releasenotes.rst new file mode 100644 index 00000000..bf07e59a --- /dev/null +++ b/docs/release/release-notes/releasenotes.rst @@ -0,0 +1,204 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Brady Johnson (Ericsson Inc.) and others + +Abstract +======== + +This document compiles the release notes for the Colorado release of +OPNFV SFC. + +Important notes +=============== + +These notes provide release information for the use of SFC with the Fuel +and Apex installer tools for the Colorado release of OPNFV. + +Summary +======= + +The goal of the SFC Colorado release is to integrate the OpenDaylight +SFC project into an OPNFV environment, with either the Fuel or Apex +installer. In subsequent releases, other OPNFV installers will be +considered. + +More information about OpenDaylight and SFC can be found here. + +- `OpenDaylight `_ version "Boron" + +- `Service function chaining `_ + + +- Documentation built by Jenkins + + - Overall OPNFV documentation + + - `Design document `_ + + - `User Guide `_ + + - `Installation Instructions `_ + + - Release Notes (this document) + + +Release Data +============ + ++--------------------------------------+--------------------------------------+ +| **Project** | sfc | +| | | ++--------------------------------------+--------------------------------------+ +| **Repo/tag** | colorado.2.0 | +| | | ++--------------------------------------+--------------------------------------+ +| **Release designation** | Colorado base release | +| | | ++--------------------------------------+--------------------------------------+ +| **Release date** | November 10 2016 | +| | | ++--------------------------------------+--------------------------------------+ +| **Purpose of the delivery** | Improve functionality provided in | +| | Brahmaputra release. Increased test | +| | coverage with new Funtest cases. | +| | Make SFC/Tacker work on multiple | +| | compute nodes | +| | | ++--------------------------------------+--------------------------------------+ + +Version change +-------------- + +Module version changes +~~~~~~~~~~~~~~~~~~~~~~ +This is the second tracked release of OPNFV sfc. It is based on +following upstream versions: + +- OpenStack Mitaka release + +- OpenDaylight Boron release + +- Open vSwitch 2.5.90 with Yi Yang NSH patch + +Document changes +~~~~~~~~~~~~~~~~ +This is the second tracked version of OPNFV SFC. It comes with +the following documentation: + +- `Design document `_ + +- `User Guide `_ + +- `Installation Instructions `_ + +- Release notes (This document) + +Reason for version +------------------ + +Feature additions +~~~~~~~~~~~~~~~~~ + +**JIRA TICKETS:** + +`JIRA EPIC with the new features in SFC Colorado `_ + +Bug corrections +~~~~~~~~~~~~~~~ + +**JIRA TICKETS:** + +`Bug-fixes `_ + +Deliverables +------------ + +Software deliverables +~~~~~~~~~~~~~~~~~~~~~ + +No specific deliverables are created, as SFC is included with Apex and Fuel. + +Documentation deliverables +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- `Design document `_ + +- `User Guide `_ + +- `Installation Instructions `_ + +- Release notes (This document) + +Known Limitations, Issues and Workarounds +========================================= + +System Limitations +------------------ + +The Colorado 2.0 release has several limitations: + +1 - OPNFV SFC only works in non-HA environments with the Fuel installer. +There is a bug in ODL which is fixed in ODL Boron SR1 and will be part +of Colorado 3.0 + +2 - Any VM (e.g. SFs) must have only one security group. +There is a bug in ODL Boron which only one security group is read. +The rest are silently ignored. This issue will be fixed in ODL +Boron SR1, which will be included in Colorado 3.0. + +Known issues +------------ + +OpenDaylight SFC relies on a version of Open vSwitch (OVS) with +Network Service Headers (NSH). A version of OVS with NSH currently +exists, but it is in a branched version of OVS. Extensive upstream +work has been done to merge the NSH patches into mainstream OVS, +but the work is still not complete. More information about this +can be found in the OPNFV SFC design document (link provided above). + +Workarounds +----------- + +The way OpenStack handles VXLAN-GPE tunnels doesnt work well with +SFC, since OpenStack terminates the VXLAN tunnels in the br-int +bridge instead of the SF VM. Ideally, the tunnel should be terminated +in the VM so the SF has access to the NSH header carried in the tunnel. +A workaround was created to send the packets to the SF VM with the +VXLAN-GPE headers intact and can be found in the OPNFV SFC design +document (link provided above). + +Test results +============ +The Colorado release of SFC has undergone QA test runs +with Functest tests on the Fuel and Apex installers. + +References +========== +For more information on the OPNFV Colorado release, please see: + +OPNFV +----- + +1) `OPNFV Home Page `_ + +2) `OPNFV documentation- and software downloads `_ + +3) `OPNFV Colorado release `_ + +OpenStack +--------- + +4) `OpenStack Mitaka Release artifacts `_ + +5) `OpenStack documentation `_ + +OpenDaylight +------------ + +6) `OpenDaylight artifacts `_ + +Open vSwitch with NSH +--------------------- + +7) https://github.com/yyang13/ovs_nsh_patches + -- cgit 1.2.3-korg