diff options
author | Brady Johnson <brady.allen.johnson@ericsson.com> | 2017-02-10 13:01:52 +0100 |
---|---|---|
committer | Brady Johnson <brady.allen.johnson@ericsson.com> | 2017-02-10 13:10:36 +0100 |
commit | 065fba5bef236f992bd5e4122e635bb21d525af9 (patch) | |
tree | 7aa1d737bfeb30b90d9236609f6ba75025636ad7 /docs/releasenotes | |
parent | 773acea6072b38a8b63433ebb53ac86dc522467b (diff) |
Migrate docs to the new Danube dir structure
Change-Id: I6bdfd21add4d04f0fee988f83888c1edcc488951
Signed-off-by: Brady Johnson <brady.allen.johnson@ericsson.com>
Diffstat (limited to 'docs/releasenotes')
-rw-r--r-- | docs/releasenotes/index.rst | 13 | ||||
-rw-r--r-- | docs/releasenotes/releasenotes.rst | 204 |
2 files changed, 0 insertions, 217 deletions
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst deleted file mode 100644 index e5e1dc60..00000000 --- a/docs/releasenotes/index.rst +++ /dev/null @@ -1,13 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 - .. (c) <optionally add copywriters name> - -***************** -SFC Release Notes -***************** - -.. toctree:: - :numbered: - :maxdepth: 2 - - releasenotes.rst diff --git a/docs/releasenotes/releasenotes.rst b/docs/releasenotes/releasenotes.rst deleted file mode 100644 index bf07e59a..00000000 --- a/docs/releasenotes/releasenotes.rst +++ /dev/null @@ -1,204 +0,0 @@ -.. 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 <http://www.opendaylight.org/software>`_ version "Boron" - -- `Service function chaining <https://wiki.opnfv.org/display/sfc/Service+Function+Chaining+Home>`_ - - -- Documentation built by Jenkins - - - Overall OPNFV documentation - - - `Design document <http://artifacts.opnfv.org/sfc/colorado/docs/design/index.html>`_ - - - `User Guide <http://artifacts.opnfv.org/sfc/colorado/docs/userguide/index.html>`_ - - - `Installation Instructions <http://artifacts.opnfv.org/sfc/colorado/docs/installationprocedure/index.html>`_ - - - 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 <http://artifacts.opnfv.org/sfc/colorado/docs/design/index.html>`_ - -- `User Guide <http://artifacts.opnfv.org/sfc/colorado/docs/userguide/index.html>`_ - -- `Installation Instructions <http://artifacts.opnfv.org/sfc/colorado/docs/installationprocedure/index.html>`_ - -- Release notes (This document) - -Reason for version ------------------- - -Feature additions -~~~~~~~~~~~~~~~~~ - -**JIRA TICKETS:** - -`JIRA EPIC with the new features in SFC Colorado <https://jira.opnfv.org/browse/SFC-33>`_ - -Bug corrections -~~~~~~~~~~~~~~~ - -**JIRA TICKETS:** - -`Bug-fixes <https://jira.opnfv.org/browse/SFC-34>`_ - -Deliverables ------------- - -Software deliverables -~~~~~~~~~~~~~~~~~~~~~ - -No specific deliverables are created, as SFC is included with Apex and Fuel. - -Documentation deliverables -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -- `Design document <http://artifacts.opnfv.org/sfc/colorado/docs/design/index.html>`_ - -- `User Guide <http://artifacts.opnfv.org/sfc/colorado/docs/userguide/index.html>`_ - -- `Installation Instructions <http://artifacts.opnfv.org/sfc/colorado/docs/installationprocedure/index.html>`_ - -- 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 <https://www.opnfv.org>`_ - -2) `OPNFV documentation- and software downloads <https://www.opnfv.org/software/download>`_ - -3) `OPNFV Colorado release <http://wiki.opnfv.org/releases/colorado>`_ - -OpenStack ---------- - -4) `OpenStack Mitaka Release artifacts <http://www.openstack.org/software/mitaka>`_ - -5) `OpenStack documentation <http://docs.openstack.org>`_ - -OpenDaylight ------------- - -6) `OpenDaylight artifacts <http://www.opendaylight.org/software/downloads>`_ - -Open vSwitch with NSH ---------------------- - -7) https://github.com/yyang13/ovs_nsh_patches - |