3027a7ea8b78017ad2d566325c55d52647982cc2
[ovsnfv.git] / docs / release / scenarios / os-nosdn-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-nosdn-ovs-noha
10
11 "apex-os-ovs-noha" is a scenario developed as part of the OVS for NFV
12 OPNFV project. The main components of the "apex-os-nosdn-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
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-noha" 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
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-ext) is performed via non-accelerated OVS.
49
50 Features of the scenario
51 ------------------------
52
53 Main features of the "apex-os-ovs-nosdn-noha" 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-noha 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 To enable the "apex-os-nosdn-ovs-noha" scenario check the appropriate settings
70 in the APEX configuration files. Those are typically found in /etc/opnfv-apex.
71
72 File "deploy_settings.yaml" choose false for sdn controller::
73
74   global_params:
75     ha_enabled: false
76
77   deploy_options:
78     sdn_controller: false
79     sdn_l3: false
80     tacker: false
81     congress: false
82     sfc: false
83     vpn: false
84
85 Validated deployment environments
86 =================================
87
88 The "os-odl_l2-ovs-noha" scenario has been deployed and tested
89 on the following sets of hardware:
90  * TBD
91
92
93 Limitations, Issues and Workarounds
94 ===================================
95
96 There are no known issues.
97
98 References
99 ==========
100
101
102   * OVS for NFV OPNFV project wiki: https://wiki.opnfv.org/display/ovsnfv
103   * Open vSwitch: http://openvswitch.org/
104   * DPDK: http://dpdk.org
105   * OPNFV Colorado release - more information: http://www.opnfv.org/colorado