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