]>
Commit | Line | Data |
---|---|---|
b1fe1c94 SF |
1 | ============ |
2 | Open vSwitch | |
3 | ============ | |
4 | ||
5 | Build Status | |
6 | ------------ | |
7 | ||
8 | .. image:: https://travis-ci.org/openvswitch/ovs.png | |
9 | :target: https://travis-ci.org/openvswitch/ovs | |
10 | ||
11 | What is Open vSwitch? | |
12 | --------------------- | |
13 | ||
14 | Open vSwitch is a multilayer software switch licensed under the open source | |
15 | Apache 2 license. Our goal is to implement a production quality switch | |
16 | platform that supports standard management interfaces and opens the forwarding | |
17 | functions to programmatic extension and control. | |
18 | ||
19 | Open vSwitch is well suited to function as a virtual switch in VM environments. | |
20 | In addition to exposing standard control and visibility interfaces to the | |
21 | virtual networking layer, it was designed to support distribution across | |
22 | multiple physical servers. Open vSwitch supports multiple Linux-based | |
23 | virtualization technologies including Xen/XenServer, KVM, and VirtualBox. | |
24 | ||
25 | The bulk of the code is written in platform-independent C and is easily ported | |
26 | to other environments. The current release of Open vSwitch supports the | |
27 | following features: | |
28 | ||
29 | - Standard 802.1Q VLAN model with trunk and access ports | |
30 | - NIC bonding with or without LACP on upstream switch | |
31 | - NetFlow, sFlow(R), and mirroring for increased visibility | |
32 | - QoS (Quality of Service) configuration, plus policing | |
33 | - Geneve, GRE, VXLAN, STT, and LISP tunneling | |
34 | - 802.1ag connectivity fault management | |
35 | - OpenFlow 1.0 plus numerous extensions | |
36 | - Transactional configuration database with C and Python bindings | |
37 | - High-performance forwarding using a Linux kernel module | |
38 | ||
39 | The included Linux kernel module supports Linux 3.10 and up. | |
40 | ||
41 | Open vSwitch can also operate, at a cost in performance, entirely in userspace, | |
42 | without assistance from a kernel module. This userspace implementation should | |
43 | be easier to port than the kernel-based switch. It is considered experimental. | |
44 | ||
45 | What's here? | |
46 | ------------ | |
47 | ||
48 | The main components of this distribution are: | |
49 | ||
50 | - ovs-vswitchd, a daemon that implements the switch, along with a companion | |
51 | Linux kernel module for flow-based switching. | |
52 | - ovsdb-server, a lightweight database server that ovs-vswitchd queries to | |
53 | obtain its configuration. | |
54 | - ovs-dpctl, a tool for configuring the switch kernel module. | |
55 | - Scripts and specs for building RPMs for Citrix XenServer and Red Hat | |
56 | Enterprise Linux. The XenServer RPMs allow Open vSwitch to be installed on a | |
57 | Citrix XenServer host as a drop-in replacement for its switch, with | |
58 | additional functionality. | |
59 | - ovs-vsctl, a utility for querying and updating the configuration of | |
60 | ovs-vswitchd. | |
61 | - ovs-appctl, a utility that sends commands to running Open vSwitch daemons. | |
62 | ||
63 | Open vSwitch also provides some tools: | |
64 | ||
65 | - ovs-ofctl, a utility for querying and controlling OpenFlow switches and | |
66 | controllers. | |
67 | - ovs-pki, a utility for creating and managing the public-key infrastructure | |
68 | for OpenFlow switches. | |
69 | - ovs-testcontroller, a simple OpenFlow controller that may be useful for | |
70 | testing (though not for production). | |
71 | - A patch to tcpdump that enables it to parse OpenFlow messages. | |
72 | ||
73 | What other documentation is available? | |
74 | -------------------------------------- | |
75 | ||
76 | To install Open vSwitch on a regular Linux or FreeBSD host, please read the | |
60230e06 | 77 | `installation guide <INSTALL.rst>`__. For specifics around installation on a |
b1fe1c94 SF |
78 | specific platform, please see one of the below installation guides: |
79 | ||
80 | - `Debian <INSTALL.Debian.rst>`__ | |
45742db4 | 81 | - `Fedora <INSTALL.Fedora.rst>`__ |
5361570f | 82 | - `RHEL <INSTALL.RHEL.rst>`__ |
b1fe1c94 SF |
83 | - `XenServer <INSTALL.XenServer.rst>`__ |
84 | - `Windows <INSTALL.Windows.rst>`__ | |
85 | ||
86 | To use Open vSwitch... | |
87 | ||
88 | - ...with Docker on Linux, see `here <INSTALL.Docker.rst>`__. | |
89 | ||
90 | - ...with KVM on Linux, see `here <INSTALL.rst>`__ and `here | |
91 | <INSTALL.KVM.rst>`__. | |
92 | ||
c278f452 | 93 | - ...with Libvirt, see `here <INSTALL.Libvirt.rst>`__. |
b1fe1c94 SF |
94 | |
95 | - ...without using a kernel module, see `here <INSTALL.userspace.rst>`__. | |
96 | ||
97 | - ...with DPDK, see `here <INSTALL.DPDK.rst>`__. | |
98 | ||
24874488 | 99 | - ...with SELinux, see `here <INSTALL.SELinux.rst>`__. |
b1fe1c94 | 100 | |
edde4861 | 101 | For answers to common questions, refer to the `FAQ <FAQ.rst>`__. |
b1fe1c94 SF |
102 | |
103 | To learn how to set up SSL support for Open vSwitch, see `here | |
4b9ba26d | 104 | <INSTALL.SSL.rst>`__. |
b1fe1c94 SF |
105 | |
106 | To learn about some advanced features of the Open vSwitch software switch, read | |
c27b7536 | 107 | the `tutorial <tutorial/tutorial.rst>`__. |
b1fe1c94 SF |
108 | |
109 | Each Open vSwitch userspace program is accompanied by a manpage. Many of the | |
110 | manpages are customized to your configuration as part of the build process, so | |
111 | we recommend building Open vSwitch before reading the manpages. | |
112 | ||
113 | Contact | |
114 | ------- | |
115 | ||
116 | bugs@openvswitch.org |