From 0f8220d5d96cc0a45be00e937c73ab938133e587 Mon Sep 17 00:00:00 2001 From: Nikolas Hermanns Date: Wed, 29 Mar 2017 12:46:53 +0200 Subject: Changing to new docs structure Change-Id: I4c15e1635981b2b5fe5473be89b5abab78bfabd5 Signed-off-by: Nikolas Hermanns --- docs/release/scenarios/os-odl_l2-bgpvpn/index.rst | 18 ++++ .../os-odl_l2-bgpvpn/scenario.description.rst | 97 ++++++++++++++++++++++ 2 files changed, 115 insertions(+) create mode 100644 docs/release/scenarios/os-odl_l2-bgpvpn/index.rst create mode 100644 docs/release/scenarios/os-odl_l2-bgpvpn/scenario.description.rst (limited to 'docs/release/scenarios') diff --git a/docs/release/scenarios/os-odl_l2-bgpvpn/index.rst b/docs/release/scenarios/os-odl_l2-bgpvpn/index.rst new file mode 100644 index 0000000..2389706 --- /dev/null +++ b/docs/release/scenarios/os-odl_l2-bgpvpn/index.rst @@ -0,0 +1,18 @@ +.. _sdnvpn-os-odl_l2-bgpvpn: + +.. 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_l2-bgpvpn/scenario.description.rst b/docs/release/scenarios/os-odl_l2-bgpvpn/scenario.description.rst new file mode 100644 index 0000000..e552bcf --- /dev/null +++ b/docs/release/scenarios/os-odl_l2-bgpvpn/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) 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 are derived +from the baseline scenarios os-odl_l2-nofeature and os-odl_l3-nofeature. This document +provides an outline of the os-odl_l2-bgpvpn scenarios including guidelines and references to +required installation, software and hardware configuration documents. + +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