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