aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorManuel Buil <mbuil@suse.com>2017-08-21 15:54:29 +0200
committerBrady Johnson <bjohnson@inocybe.com>2017-08-23 15:05:24 +0000
commit0a9106c39f131a1d2952e1187ee1d1924d84e1f6 (patch)
tree3872149bb4444f86e9399fb95d32c57a2631906a /docs
parentc6fcfcaa891d0c7a1e63feeca675e64fdaf7cb40 (diff)
Added new fdio scenarios descriptions
As part of MS6 we must have an updated directory structure. I added the two new scenarios using fdio Change-Id: If74dade8c75c59d452b034b98fff5dc0791b2191 Signed-off-by: Manuel Buil <mbuil@suse.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/release/scenarios/os-odl-sfc-ha/index.rst (renamed from docs/release/scenarios/os-odl_l2-sfc-ha/index.rst)4
-rw-r--r--docs/release/scenarios/os-odl-sfc-ha/scenario.description.rst (renamed from docs/release/scenarios/os-odl_l2-sfc-ha/scenario.description.rst)27
-rw-r--r--docs/release/scenarios/os-odl-sfc-noha/index.rst (renamed from docs/release/scenarios/os-odl_l2-sfc-noha/index.rst)4
-rw-r--r--docs/release/scenarios/os-odl-sfc-noha/scenario.description.rst (renamed from docs/release/scenarios/os-odl_l2-sfc-noha/scenario.description.rst)26
-rw-r--r--docs/release/scenarios/os-odl-sfc_fdio-ha/index.rst18
-rw-r--r--docs/release/scenarios/os-odl-sfc_fdio-ha/scenario.description.rst97
-rw-r--r--docs/release/scenarios/os-odl-sfc_fdio-noha/index.rst18
-rw-r--r--docs/release/scenarios/os-odl-sfc_fdio-noha/scenario.description.rst101
8 files changed, 264 insertions, 31 deletions
diff --git a/docs/release/scenarios/os-odl_l2-sfc-ha/index.rst b/docs/release/scenarios/os-odl-sfc-ha/index.rst
index 00d414a6..d979a95c 100644
--- a/docs/release/scenarios/os-odl_l2-sfc-ha/index.rst
+++ b/docs/release/scenarios/os-odl-sfc-ha/index.rst
@@ -1,11 +1,11 @@
-.. _os-odl_l2-sfc-ha:
+.. _os-odl-sfc-ha:
.. 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>
=========================================
-os-odl_l2-sfc-ha overview and description
+os-odl-sfc-ha overview and description
=========================================
.. This document will be used to provide a description of the scenario for an end user.
.. You should explain the purpose of the scenario, the types of capabilities provided and
diff --git a/docs/release/scenarios/os-odl_l2-sfc-ha/scenario.description.rst b/docs/release/scenarios/os-odl-sfc-ha/scenario.description.rst
index 881ca967..249b0bd7 100644
--- a/docs/release/scenarios/os-odl_l2-sfc-ha/scenario.description.rst
+++ b/docs/release/scenarios/os-odl-sfc-ha/scenario.description.rst
@@ -6,9 +6,9 @@ Introduction
============
.. In this section explain the purpose of the scenario and the types of capabilities provided
-The os-odl_l2-sfc-ha is intended to be used to install the OPNFV SFC project in a standard
+The os-odl-sfc-ha is intended to be used to install the OPNFV SFC project in a standard
OPNFV High Availability mode. The OPNFV SFC project integrates the OpenDaylight SFC project
-into the OPNFV environment. The OPNFV SFC Danube release uses the OpenDaylight Boron SR2 release.
+into the OPNFV environment. The OPNFV SFC Euphrates release uses the OpenDaylight Nitrogen SR1 release.
Scenario components and composition
===================================
@@ -37,17 +37,17 @@ The following are the SFC features that get installed:
The following are the Netvirt features that get installed:
-- odl-ovsdb-openstack
-- odl-mdsal-xsql
+- odl-netvirt-openstack
+- odl-sfc-genius
- odl-neutron-service
- odl-neutron-northbound-api
- odl-neutron-spi
- odl-neutron-transcriber
-- odl-mdsal-apidocs
-- odl-ovsdb-southbound-impl-rest
-- odl-ovsdb-southbound-impl-ui
+- odl-ovsdb-southbound-impl-api
+- odl-ovsdb-southbound-impl-impl
+- odl-ovsdb-library
-By simply installing the odl-ovsdb-openstack feature, all the dependant features
+By simply installing the odl-netvirt-sfc feature, all the dependant features
will automatically be installed.
The VNF Manager
@@ -56,7 +56,7 @@ The VNF Manager
In order to create a VM for each Service Function, a VNF Manager is needed. The OPNFV
SFC project currently uses the Tacker OpenStack project as a VNF Manager. Tacker is
installed on the controller node and manages VNF life cycle, and coordinates VM creation
-with the OpenDaylight SFC project.
+and SFC configuration with OpenStack and OpenDaylight SFC project.
Scenario usage overview
=======================
@@ -76,7 +76,7 @@ Limitations, Issues and Workarounds
The *client* virtual machine needs to be located in a compute node where at least
one of the service functions (SFs) is placed. This is due to a limitation in OpenDaylight,
-Boron, which only installs the traffic classifier in the compute nodes where the SFs are.
+Nitrogen, which only installs the traffic classifier in the compute nodes where the SFs are.
Specific version of OVS
-----------------------
@@ -84,7 +84,7 @@ Specific version of OVS
SFC needs changes in OVS to include the Network Service Headers (NSH) Service Chaining
encapsulation. This OVS patch has been ongoing for quite a while (2 years+), and still
has not been officially merged. Previously, SFC used NSH from a branched version of OVS
-based on 2.3.90, called the "Pritesh Patch". In the OpenDaylight Boron SR2 release, SFC was
+based on 2.3.90, called the "Pritesh Patch". In the OpenDaylight Nitrogen SR1 release, SFC was
changed to use a newer, branched version of OVS based on 2.6.1, called the "Yi Yang
Patch".
@@ -115,7 +115,6 @@ https://wiki.opnfv.org/display/sfc/Service+Function+Chaining+Home
https://wiki.opendaylight.org/view/Service_Function_Chaining:Main
-For more information on the OPNFV Danube release, please visit:
-
-http://www.opnfv.org/danube
+For more information on the OPNFV Euphrates release, please visit:
+http://www.opnfv.org/euphrates
diff --git a/docs/release/scenarios/os-odl_l2-sfc-noha/index.rst b/docs/release/scenarios/os-odl-sfc-noha/index.rst
index ba55ab5f..e416ca86 100644
--- a/docs/release/scenarios/os-odl_l2-sfc-noha/index.rst
+++ b/docs/release/scenarios/os-odl-sfc-noha/index.rst
@@ -1,11 +1,11 @@
-.. _os-odl_l2-sfc-noha:
+.. _os-odl-sfc-noha:
.. 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>
===========================================
-os-odl_l2-sfc-noha overview and description
+os-odl-sfc-noha overview and description
===========================================
.. This document will be used to provide a description of the scenario for an end user.
.. You should explain the purpose of the scenario, the types of capabilities provided and
diff --git a/docs/release/scenarios/os-odl_l2-sfc-noha/scenario.description.rst b/docs/release/scenarios/os-odl-sfc-noha/scenario.description.rst
index 74d386b0..691c0931 100644
--- a/docs/release/scenarios/os-odl_l2-sfc-noha/scenario.description.rst
+++ b/docs/release/scenarios/os-odl-sfc-noha/scenario.description.rst
@@ -6,10 +6,10 @@ Introduction
============
.. In this section explain the purpose of the scenario and the types of capabilities provided
-The os-odl_l2-sfc-noha is intended to be used to install the OPNFV SFC project in a standard
+The os-odl-sfc-noha is intended to be used to install the OPNFV SFC project in a standard
OPNFV Non-High Availability mode. The OPNFV SFC project integrates the OpenDaylight SFC
-project into the OPNFV environment. The OPNFV SFC Danube release uses the OpenDaylight
-Boron SR2 release.
+project into the OPNFV environment. The OPNFV SFC Euphrates release uses the OpenDaylight
+Nitrogen SR1 release.
Scenario components and composition
===================================
@@ -39,17 +39,17 @@ The following are the SFC features that get installed:
The following are the Netvirt features that get installed:
-- odl-ovsdb-openstack
-- odl-mdsal-xsql
+- odl-netvirt-openstack
+- odl-sfc-genius
- odl-neutron-service
- odl-neutron-northbound-api
- odl-neutron-spi
- odl-neutron-transcriber
-- odl-mdsal-apidocs
-- odl-ovsdb-southbound-impl-rest
-- odl-ovsdb-southbound-impl-ui
+- odl-ovsdb-southbound-impl-api
+- odl-ovsdb-southbound-impl-impl
+- odl-ovsdb-library
-By simply installing the odl-ovsdb-openstack feature, all the dependant features
+By simply installing the odl-netvirt-sfc feature, all the dependant features
will automatically be installed.
The VNF Manager
@@ -78,7 +78,7 @@ Limitations, Issues and Workarounds
The *client* virtual machine needs to be located in a compute node where at least
one of the service functions (SFs) is placed. This is due to a limitation in OpenDaylight,
-Boron, which only installs the traffic classifier in the compute nodes where the SFs are.
+Nitrogen, which only installs the traffic classifier in the compute nodes where the SFs are.
Specific version of OVS
-----------------------
@@ -86,7 +86,7 @@ Specific version of OVS
SFC needs changes in OVS to include the Network Service Headers (NSH) Service Chaining
encapsulation. This OVS patch has been ongoing for quite a while (2 years+), and still
has not been officially merged. Previously, SFC used NSH from a branched version of OVS
-based on 2.3.90, called the "Pritesh Patch". In the OpenDaylight Boron SR2 release, SFC was
+based on 2.3.90, called the "Pritesh Patch". In the OpenDaylight Nitrogen SR1 release, SFC was
changed to use a newer, branched version of OVS based on 2.6.1, called the "Yi Yang
Patch".
@@ -117,7 +117,7 @@ https://wiki.opnfv.org/display/sfc/Service+Function+Chaining+Home
https://wiki.opendaylight.org/view/Service_Function_Chaining:Main
-For more information on the OPNFV Danube release, please visit:
+For more information on the OPNFV Euphrates release, please visit:
-http://www.opnfv.org/danube
+http://www.opnfv.org/euphrates
diff --git a/docs/release/scenarios/os-odl-sfc_fdio-ha/index.rst b/docs/release/scenarios/os-odl-sfc_fdio-ha/index.rst
new file mode 100644
index 00000000..28413b2e
--- /dev/null
+++ b/docs/release/scenarios/os-odl-sfc_fdio-ha/index.rst
@@ -0,0 +1,18 @@
+.. _os-odl-sfc_fdio-ha:
+
+.. 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>
+
+=========================================
+os-odl-sfc_fdio-ha overview and description
+=========================================
+.. This document will be used to provide a description of the scenario for an end user.
+.. You should explain the purpose of the scenario, the types of capabilities provided and
+.. the unique components that make up the scenario including how they are used.
+
+.. toctree::
+ :maxdepth: 3
+
+ ./scenario.description.rst
+
diff --git a/docs/release/scenarios/os-odl-sfc_fdio-ha/scenario.description.rst b/docs/release/scenarios/os-odl-sfc_fdio-ha/scenario.description.rst
new file mode 100644
index 00000000..39efcacd
--- /dev/null
+++ b/docs/release/scenarios/os-odl-sfc_fdio-ha/scenario.description.rst
@@ -0,0 +1,97 @@
+.. 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>
+
+Introduction
+============
+.. In this section explain the purpose of the scenario and the types of capabilities provided
+
+The os-odl-sfc_fdio-ha is intended to be used to install the OPNFV SFC project in a standard
+OPNFV High Availability mode. The OPNFV SFC project integrates the OpenDaylight SFC project
+into the OPNFV environment. The OPNFV SFC Euphrates release uses the OpenDaylight Nitrogen SR1 release.
+
+Scenario components and composition
+===================================
+.. In this section describe the unique components that make up the scenario,
+.. what each component provides and why it has been included in order
+.. to communicate to the user the capabilities available in this scenario.
+
+This scenario installs everything needed to use the SFC OpenDaylight project in an OPNFV
+environment. The classifier used in this scenario is implemented by the Netvirt OpenDaylight
+project.
+
+Following is a detailed list of what is included with this scenario:
+
+OpenDaylight features installed
+-------------------------------
+
+The OpenDaylight SDN controller is installed in the controller node.
+
+The following are the SFC features that get installed:
+
+- odl-sfc-model
+- odl-sfc-provider
+- odl-sfc-provider-rest
+- odl-sfc-ovs
+- odl-sfc-openflow-renderer
+
+The following are the Netvirt features that get installed:
+
+- odl-netvirt-openstack
+- odl-sfc-genius
+- odl-neutron-service
+- odl-neutron-northbound-api
+- odl-neutron-spi
+- odl-neutron-transcriber
+- odl-ovsdb-southbound-impl-api
+- odl-ovsdb-southbound-impl-impl
+- odl-ovsdb-library
+
+By simply installing the odl-netvirt-sfc feature, all the dependant features
+will automatically be installed.
+
+The VNF Manager
+---------------
+
+In order to create a VM for each Service Function, a VNF Manager is needed. The OPNFV
+SFC project currently uses the Tacker OpenStack project as a VNF Manager. Tacker is
+installed on the controller node and manages VNF life cycle, and coordinates VM creation
+and SFC configuration with OpenStack and OpenDaylight SFC project.
+
+Scenario usage overview
+=======================
+.. Provide a brief overview on how to use the scenario and the features available to the
+.. user. This should be an "introduction" to the userguide document, and explicitly link to it,
+.. where the specifics of the features are covered including examples and API's
+
+Once this scenario is installed, it will be possible to create Service Chains and
+classification entries to map tenant traffic to individual, pre-defined Service Chains.
+All configuration can be performed using the Tacker CLI.
+
+Limitations, Issues and Workarounds
+===================================
+.. Explain scenario limitations here, this should be at a design level rather than discussing
+.. faults or bugs. If the system design only provide some expected functionality then provide
+.. some insight at this point.
+
+The *client* virtual machine needs to be located in a compute node where at least
+one of the service functions (SFs) is placed. This is due to a limitation in OpenDaylight,
+Nitrogen, which only installs the traffic classifier in the compute nodes where the SFs are.
+
+Specific version of FD.IO
+-----------------------
+
+TO BE ADDED
+
+References
+==========
+
+For more information about SFC, please visit:
+
+https://wiki.opnfv.org/display/sfc/Service+Function+Chaining+Home
+
+https://wiki.opendaylight.org/view/Service_Function_Chaining:Main
+
+For more information on the OPNFV Euphrates release, please visit:
+
+http://www.opnfv.org/euphrates
diff --git a/docs/release/scenarios/os-odl-sfc_fdio-noha/index.rst b/docs/release/scenarios/os-odl-sfc_fdio-noha/index.rst
new file mode 100644
index 00000000..a77bc4c5
--- /dev/null
+++ b/docs/release/scenarios/os-odl-sfc_fdio-noha/index.rst
@@ -0,0 +1,18 @@
+.. _os-odl-sfc_fdio-noha:
+
+.. 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>
+
+===========================================
+os-odl-sfc_fdio-noha overview and description
+===========================================
+.. This document will be used to provide a description of the scenario for an end user.
+.. You should explain the purpose of the scenario, the types of capabilities provided and
+.. the unique components that make up the scenario including how they are used.
+
+.. toctree::
+ :maxdepth: 3
+
+ ./scenario.description.rst
+
diff --git a/docs/release/scenarios/os-odl-sfc_fdio-noha/scenario.description.rst b/docs/release/scenarios/os-odl-sfc_fdio-noha/scenario.description.rst
new file mode 100644
index 00000000..6ef8c4ba
--- /dev/null
+++ b/docs/release/scenarios/os-odl-sfc_fdio-noha/scenario.description.rst
@@ -0,0 +1,101 @@
+.. 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>
+
+Introduction
+============
+.. In this section explain the purpose of the scenario and the types of capabilities provided
+
+The os-odl-sfc_fdio-noha is intended to be used to install the OPNFV SFC project in a standard
+OPNFV Non-High Availability mode. The OPNFV SFC project integrates the OpenDaylight SFC
+project into the OPNFV environment. The OPNFV SFC Euphrates release uses the OpenDaylight
+Nitrogen SR1 release.
+
+Scenario components and composition
+===================================
+.. In this section describe the unique components that make up the scenario,
+.. what each component provides and why it has been included in order
+.. to communicate to the user the capabilities available in this scenario.
+
+This scenario installs everything needed to use the SFC OpenDaylight project in an OPNFV
+environment. Since this scenario is Non-High Availability, then only one controller and
+one compute node will be deployed. The classifier used in this scenario is implemented
+by the Netvirt OpenDaylight project.
+
+Following is a detailed list of what is included with this scenario:
+
+OpenDaylight features installed
+-------------------------------
+
+The OpenDaylight SDN controller is installed in the controller node.
+
+The following are the SFC features that get installed:
+
+- odl-sfc-model
+- odl-sfc-provider
+- odl-sfc-provider-rest
+- odl-sfc-ovs
+- odl-sfc-openflow-renderer
+
+The following are the Netvirt features that get installed:
+
+- odl-netvirt-openstack
+- odl-sfc-genius
+- odl-neutron-service
+- odl-neutron-northbound-api
+- odl-neutron-spi
+- odl-neutron-transcriber
+- odl-ovsdb-southbound-impl-api
+- odl-ovsdb-southbound-impl-impl
+- odl-ovsdb-library
+
+By simply installing the odl-netvirt-sfc feature, all the dependant features
+will automatically be installed.
+
+The VNF Manager
+---------------
+
+In order to create a VM for each Service Function, a VNF Manager is needed. The OPNFV
+SFC project currently uses the Tacker OpenStack project as a VNF Manager. Tacker is
+installed on the controller node and manages VNF life cycle, and coordinates VM creation
+with the OpenDaylight SFC project.
+
+Scenario usage overview
+=======================
+.. Provide a brief overview on how to use the scenario and the features available to the
+.. user. This should be an "introduction" to the userguide document, and explicitly link to it,
+.. where the specifics of the features are covered including examples and API's
+
+Once this scenario is installed, it will be possible to create Service Chains and
+classification entries to map tenant traffic to individual, pre-defined Service Chains.
+All configuration can be performed using the Tacker CLI.
+
+Limitations, Issues and Workarounds
+===================================
+.. Explain scenario limitations here, this should be at a design level rather than discussing
+.. faults or bugs. If the system design only provide some expected functionality then provide
+.. some insight at this point.
+
+The *client* virtual machine needs to be located in a compute node where at least
+one of the service functions (SFs) is placed. This is due to a limitation in OpenDaylight,
+Nitrogen, which only installs the traffic classifier in the compute nodes where the SFs are.
+
+Specific version of FD.IO
+-----------------------
+
+TO BE ADDED
+
+
+References
+==========
+
+For more information about SFC, please visit:
+
+https://wiki.opnfv.org/display/sfc/Service+Function+Chaining+Home
+
+https://wiki.opendaylight.org/view/Service_Function_Chaining:Main
+
+For more information on the OPNFV Euphrates release, please visit:
+
+http://www.opnfv.org/euphrates
+