Add and update apex sdn and ovs scenarios to Danube 1.0
[ovsnfv.git] / docs / release / scenarios / os-odl_l3-ovs-ha / scenario.description.rst
1 .. OPNFV - Open Platform for Network Function Virtualization
2 .. This work is licensed under a Creative Commons Attribution 4.0
3 .. International License.
4 .. http://creativecommons.org/licenses/by/4.0
5
6 Scenario: "OpenStack - ovs-nfv"
7 =============================
8
9 Scenario: apex-os-odl_l3-ovs-ha
10
11 "apex-os-odl_l3-ovs-ha" is a scenario developed as part of the OVS for NFV
12 OPNFV project. The main components of the "apex-os-odl_l3-ovs-ha" scenario
13 are:
14
15  - APEX (TripleO) installer (please also see APEX installer documentation)
16  - Openstack (in HA configuration)
17  - OVS/DPDK Open vSwitch with DPDK data plane virtual forwarder for tenant networking
18  - ODL Open Daylight service running on a single controller
19  - One or more compute hosts or nodes
20
21 Introduction
22 ============
23
24 NFV and virtualized high performance applications, such as video processing,
25 require Open vSwitch to be accelerated with a fast data plane solution that provides both
26 carrier grade forwarding performance, scalability and open extensibility.
27
28 A key component of any NFV solution is the virtual forwarder, which should consist of
29 soft switch that includes an accelerated data plane component. For this, any virtual
30 switch should make use of
31 hardware accelerators and optimized cache operation to be run in user space.
32
33 The apex-os-odl_l3-ovs-ha scenario provides
34 use-cases for deployment of NFV nodes instantiated by
35 an Openstack orchestration system on OVS/DPDK enabled compute nodes
36 with Open Daylight controller service.
37
38 A deployment of the "apex-os-odl_l3-ovs-ha" scenario consists of 3 or more
39 servers:
40
41   * 1 Jumphost hosting the APEX installer - running the Undercloud
42   * 1 Controlhost, which runs the Overcloud, Openstack services,
43   and Open Daylight service.
44   * 1 or more Computehosts or nodes
45
46 .. image:: ovs4nfv.png
47
48 Tenant networking leverages Open vSwitch accelerated with a fast user space data path such
49 as DPDK.
50 Open VSwitch (OVS) with the Linux kernel module data path is used for all other
51 connectivity, such as connectivity to public networking "the
52 Internet" (i.e. br-ex) is performed via non-accelerated OVS with Linux kernel data path.
53
54 Features of the scenario
55 ------------------------
56
57 Main features of the "apex-os-ovs-nosdn-ha" scenario:
58
59   * Automated installation using the APEX installer
60   * Accelerated tenant networking using OVS/DPDK as the forwarder
61   * VXLAN l3 tenant network support with accelerated DPDK ports.
62
63 Networking in this scenario using OVS with accelerated User space IO.
64 ---------------------------------------------------------------------
65
66 The apex-os-odl_l3-ovs-ha scenario combines components from three open
67 source projects: OpenStack, Open vSwitch and DPDK. To make accelerated networking
68 available for this scenario Open vSwitch is bound via its netdev interface
69 with DPDK user space accelerated capability.
70
71 Scenario Configuration
72 ======================
73
74 Simply deploy this scenario by using the os-odl_l3-ovs-ha.yaml deploy
75 settings file.
76
77 Validated deployment environments
78 =================================
79
80 The "os-odl_l3-ovs-ha" scenario has been deployed and tested
81 on the following sets of hardware:
82  * virtual deployments only
83  * Not yet validated on UCS hardware
84
85
86 Limitations, Issues and Workarounds
87 ===================================
88
89 * _APEX-415 br-phy dpdk interfaces are not brought up by os-net-config
90
91 References
92 ==========
93
94
95   * OVS for NFV OPNFV project wiki: https://wiki.opnfv.org/display/ovsnfv
96   * Open vSwitch: http://openvswitch.org/
97   * DPDK: http://dpdk.org
98   * OPNFV Danube release - more information: http://www.opnfv.org/colorado