]>
Commit | Line | Data |
---|---|---|
064af421 BP |
1 | Open vSwitch <http://openvswitch.org> |
2 | ||
3 | What is Open vSwitch? | |
4 | --------------------- | |
5 | ||
e5660bae KA |
6 | Open vSwitch is a multilayer software switch licensed under the open |
7 | source Apache 2 license. Our goal is to implement a production | |
8 | quality switch platform that supports standard management interfaces | |
9 | (e.g. NetFlow, RSPAN, ERSPAN, IOS-like CLI), and opens the forwarding | |
10 | functions to programmatic extension and control. | |
11 | ||
12 | Open vSwitch is well suited to function as a virtual switch in VM | |
13 | environments. In addition to exposing standard control and visibility | |
14 | interfaces to the virtual networking layer, it was designed to support | |
15 | distribution across multiple physical servers. Open vSwitch supports | |
16 | multiple Linux-based virtualization technologies including | |
17 | Xen/XenServer, KVM, and VirtualBox. | |
18 | ||
19 | The bulk of the code is written in platform-independent C and is | |
20 | easily ported to other environments. The current release of Open | |
21 | vSwitch supports the following features: | |
22 | ||
23 | * Visibility into inter-VM communication via NetFlow, SPAN, and RSPAN | |
24 | * Standard 802.1Q VLAN model with trunking | |
25 | * Per VM policing | |
26 | * NIC bonding with source-MAC load balancing | |
27 | * Kernel-based forwarding | |
28 | * Support for OpenFlow | |
29 | * Compatibility layer for the Linux bridging code | |
064af421 | 30 | |
4b11d5e8 BP |
31 | Open vSwitch supports Linux 2.6.15 and up, with testing focused on |
32 | 2.6.18 with Centos and Xen patches and version 2.6.26 from kernel.org. | |
33 | Open vSwitch also has special support for Citrix XenServer hosts. | |
34 | ||
064af421 BP |
35 | What's here? |
36 | ------------ | |
37 | ||
4b11d5e8 BP |
38 | The main components of this distribution are: |
39 | ||
f30f26be JP |
40 | * ovs-vswitchd, a daemon that implements the switch, along with |
41 | a companion Linux kernel module for flow-based switching. | |
064af421 | 42 | |
f30f26be JP |
43 | * ovs-brcompatd, a daemon that allows ovs-vswitchd to act as a |
44 | drop-in replacement for the Linux bridge in many environments, | |
45 | along with a companion Linux kernel module to intercept bridge | |
46 | ioctls. | |
064af421 | 47 | |
f30f26be | 48 | * ovs-dpctl, a tool for configuring the switch kernel module. |
064af421 | 49 | |
f30f26be JP |
50 | * Scripts and specs for building RPMs that allow Open vSwitch |
51 | to be installed on a Citrix XenServer host as a drop-in | |
52 | replacement for its switch, with additional functionality. | |
4b11d5e8 | 53 | |
3b135da3 BP |
54 | * ovs-vsctl, a utility for querying and updating the configuration |
55 | of ovs-vswitchd. | |
56 | ||
57 | * ovs-appctl, a utility that sends commands to running Open | |
58 | vSwitch daemons. | |
064af421 | 59 | |
4b11d5e8 BP |
60 | Open vSwitch also provides an OpenFlow implementation and tools for |
61 | those interested in OpenFlow but not additional Open vSwitch features: | |
064af421 | 62 | |
8cd4882f BP |
63 | * ovs-openflowd, a program that implements a simple OpenFlow |
64 | switch (without the special features provided by ovs-vswitchd) | |
65 | using the same kernel module as ovs-vswitchd. | |
064af421 | 66 | |
f30f26be | 67 | * ovs-controller, a simple OpenFlow controller. |
064af421 | 68 | |
f30f26be JP |
69 | * ovs-ofctl, a utility for querying and controlling OpenFlow |
70 | switches and controllers. | |
064af421 | 71 | |
f30f26be JP |
72 | * ovs-pki, a utility for creating and managing the public-key |
73 | infrastructure for OpenFlow switches. | |
064af421 | 74 | |
f30f26be | 75 | * A patch to tcpdump that enables it to parse OpenFlow messages. |
064af421 | 76 | |
4b11d5e8 BP |
77 | What other documentation is available? |
78 | -------------------------------------- | |
064af421 | 79 | |
4b11d5e8 | 80 | To install Open vSwitch on a regular Linux machine, read INSTALL.Linux. |
064af421 | 81 | |
5fca1acd BP |
82 | To use Open vSwitch as a drop-in replacement for the Linux bridge, |
83 | read INSTALL.bridge. | |
84 | ||
4b11d5e8 BP |
85 | To build RPMs for installing Open vSwitch on a Citrix XenServer host |
86 | or resource pool, read INSTALL.XenServer. | |
064af421 | 87 | |
4b11d5e8 | 88 | To learn set up SSL support for Open vSwitch, read INSTALL.SSL. |
064af421 | 89 | |
4b11d5e8 BP |
90 | Each Open vSwitch userspace program is accompanied by a manpage. Many |
91 | of the manpages are customized to your configuration as part of the | |
92 | build process, so we recommend building Open vSwitch before reading | |
93 | the manpages. | |
064af421 BP |
94 | |
95 | Contact | |
96 | ------- | |
97 | ||
37ea6436 | 98 | bugs@openvswitch.org |
064af421 | 99 | http://openvswitch.org/ |