]>
Commit | Line | Data |
---|---|---|
d377243b BP |
1 | Using Open vSwitch without kernel support |
2 | ========================================= | |
3 | ||
4 | Open vSwitch can operate, at a cost in performance, entirely in | |
5 | userspace, without assistance from a kernel module. This file | |
6 | explains how to install Open vSwitch in such a mode. | |
7 | ||
8 | The userspace-only mode of Open vSwitch is considered experimental. | |
9 | It has not been thoroughly tested. | |
10 | ||
11 | This version of Open vSwitch should be built manually with "configure" | |
12 | and "make". Debian packaging for Open vSwitch is also included, but | |
13 | it has not been recently tested, and so Debian packages are not a | |
14 | recommended way to use this version of Open vSwitch. | |
15 | ||
16 | Building and Installing | |
17 | ----------------------- | |
18 | ||
19 | The requirements and procedure for building, installing, and | |
20 | configuring Open vSwitch are the same as those given in INSTALL.Linux. | |
21 | You may omit configuring, building, and installing the kernel module, | |
22 | and the related requirements. | |
23 | ||
24 | On Linux, the userspace switch additionally requires the kernel | |
25 | TUN/TAP driver to be available, either built into the kernel or loaded | |
26 | as a module. If you are not sure, check for a directory named | |
27 | /sys/class/misc/tun. If it does not exist, then attempt to load the | |
28 | module with "modprobe tun". | |
29 | ||
30 | The tun device must also exist as /dev/net/tun. If it does not exist, | |
31 | then create /dev/net (if necessary) with "mkdir /dev/net", then create | |
32 | /dev/net/tun with "mknod /dev/net/tun c 10 200". | |
33 | ||
e3e9370b BP |
34 | Using the Userspace Datapath with ovs-vswitchd |
35 | ---------------------------------------------- | |
d377243b BP |
36 | |
37 | To use ovs-vswitchd in userspace mode, give the bridge a name that | |
38 | begins with "netdev:" in the configuration file. For example: | |
39 | ||
40 | bridge.netdev:br0.port=eth0 | |
41 | bridge.netdev:br0.port=eth1 | |
42 | bridge.netdev:br0.port=eth2 | |
43 | ||
44 | ovs-vswitchd will create a TAP device as the bridge's local interface, | |
45 | named the same as the bridge minus the "netdev:" prefix, as well as | |
46 | for each configured internal interface. | |
47 | ||
e3e9370b BP |
48 | Using the Userspace Datapath with ovs-openflowd |
49 | ----------------------------------------------- | |
50 | ||
51 | To use ovs-openflowd in userspace mode, specify a datapath name that | |
52 | begins with "netdev:", and specify --ports with the names of the ports | |
53 | that should be included in the datapath as argument. For example: | |
54 | ||
55 | ovs-openflowd netdev:br0 --ports=eth0,eth1,eth2 | |
56 | ||
57 | ovs-openflowd will create a TAP device as the bridge's local | |
58 | interface, named the same as the bridge minus the "netdev:" prefix. | |
59 | ||
d377243b BP |
60 | Bug Reporting |
61 | ------------- | |
62 | ||
63 | Please report problems to bugs@openvswitch.org. |