From b5f0067d1e1d9e4744a4185186f072c420ddb0fe Mon Sep 17 00:00:00 2001 From: Tim Irnich Date: Wed, 18 Oct 2017 13:32:26 +0200 Subject: Adding scenario documentation Adding the scenario documentation, which was missing from previous commit. JIRA: SDNVPN-185 Change-Id: I5b4f79f51ecd50a2bc514ca0e845679604716143 Signed-off-by: Tim Irnich (cherry picked from commit 66f4fcfc64ed884b5adb2e78447b44ec0639fc6c) --- docs/release/scenarios/os-odl-bgpvpn/index.rst | 20 ++++ .../os-odl-bgpvpn/scenario.description.rst | 115 +++++++++++++++++++++ 2 files changed, 135 insertions(+) create mode 100644 docs/release/scenarios/os-odl-bgpvpn/index.rst create mode 100644 docs/release/scenarios/os-odl-bgpvpn/scenario.description.rst (limited to 'docs') diff --git a/docs/release/scenarios/os-odl-bgpvpn/index.rst b/docs/release/scenarios/os-odl-bgpvpn/index.rst new file mode 100644 index 0000000..b50ac21 --- /dev/null +++ b/docs/release/scenarios/os-odl-bgpvpn/index.rst @@ -0,0 +1,20 @@ +.. _sdnvpn-os-odl-bgpvpn-noha: + +.. _sdnvpn-os-odl-bgpvpn-ha: + +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Tim Irnich and others + +========================================= +os-odl_l2-bgpvpn 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-bgpvpn/scenario.description.rst b/docs/release/scenarios/os-odl-bgpvpn/scenario.description.rst new file mode 100644 index 0000000..af102cb --- /dev/null +++ b/docs/release/scenarios/os-odl-bgpvpn/scenario.description.rst @@ -0,0 +1,115 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Tim Irnich (tim.irnich@ericsson.com) and Nikolas Hermanns (nikolas.hermanns@ericsson.com) + +Introduction +============ +.. In this section explain the purpose of the scenario and the types of capabilities provided + +Many Telecom network functions are relying on layer-3 infrastructure +services, within a VNF between components, or towards existing external +networks. In many cases, these external networks are implemented in +MPLS/BGP technology in existing service provider wide-area-networks +(WAN). This proven technology provides a good mechanism for +inter-operation of a NFV Infrastructure (NFVI) and wide-area networks +(WAN) and is the main capability provided by the OPNFV SDNVPN project. + +.. should we explain here what a deployment scenario is? + +The OPNFV SDNVPN feature is made available through additional OPNFV +deployment scenarios, which is derived from the baseline +os-odl-nofeature scenario. + +The BGPVPN feature enables creation of BGP VPNs on the Neutron API +according to the OpenStack BGPVPN blueprint at +https://blueprints.launchpad.net/neutron/+spec/neutron-bgp-vpn. In a +nutshell, the blueprint defines a BGPVPN object and a number of ways how +to associate it with the existing Neutron object model, as well as a +unique definition of the related semantics. The BGPVPN framework +supports a backend driver model with currently available drivers for +Bagpipe, OpenContrail, Nuage and OpenDaylight. The OPNFV scenario makes +use of the OpenDaylight driver and backend implementation through the +ODL NetVirt project. + + + +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. + +The SDN VPN feature enhances OPNFV's baseline OpenStack deployment with +the possibility to configure BGP based VPNs using the Neutron API +extension and service plugin provided by the OpenStack Neutron Stadium +project BGPVPN. The BGPVPN project consists of a Neutron API extension +and a service plugin which has a driver framework similar to the ML2 +plugin. BGPVPN today has a quite large number of backend drivers +(Bagpipe, OpenContrail, Nuage and OpenDaylight currently). In OPNFV, +currently only the OpenDaylight driver is supported. + +The BGPVPN ODL driver maps the BGPVPN API onto the OpenDaylight NetVirt +service, which exposes the data center overlay like a virtual router to +which Neutron Networks and Routers (and in the future also Ports) are +connected. NetVirt has access to the state of the Neutron API through +the OpenDaylight Neutron Northbound Interface module, which has been +enhanced to support the BGPVPN API extension. It uses an internal mesh +of VxLAN tunnels to interconnect the vSwitches on the data center +compute nodes. For the purpose of BGP based route exchange with other +BGP speakers the ODL controller makes use of Quagga BGP as an external +BGP speaker. + + +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 user guide document, and explicitly link to it, +.. where the specifics of the features are covered including examples and API's + + When would I use this scenario, what value does it provide? Refer to the user guide for details + of configuration etc... + +Configuring SDNVPN features +--------------------------- + +Each installer has specific procedures to deploy the OPNFV platform so that the SDNVPN feature is enabled. + +Fuel installer configuration +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To install the SDNVPN feature using Fuel, follow the Fuel installation guide ensuring to select the SDNVPN +feature when prompted . + +This will trigger installation of the OpenStack BGPVPN API extension for +Neutron, set up for using the ODL driver, in addition to vanilla Neutron. +In addition, the required karaf features will be activated when ODL is installed and the compute nodes +will be configured including the VPN Service internal transport tunnel mesh. + +No post-deploy configuration is necessary. The Fuel BGPVPN plugin and the ODL plugin +should set up the cluster ready for BGPVPNs being created. + +APEX installer configuration +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To install the SDNVPN feature using the APEX installer, follow the APEX installation guide and +activate the SDNVPN feature when prompted. + +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. + +Currently, in OPNFV only ODL is supported as a backend for BGPVPN. API calls are +mapped onto the ODL NetVirt REST API through the BGPVPN ODL driver and the +ODL Neutron Northbound module. + +No DPDK-enabled vhost user ports are supported. + +Integration with data center gateway will not work due to missing OVS patches for MPLSoGRE. + +References +========== + +For more information on the OPNFV Danube release, please visit +http://www.opnfv.org/danube -- cgit 1.2.3-korg