]>
Commit | Line | Data |
---|---|---|
91005f03 BP |
1 | .de IQ |
2 | . br | |
3 | . ns | |
4 | . IP "\\$1" | |
5 | .. | |
d2cb6c95 | 6 | .TH ovs\-vlan\-test 1 "@VERSION@" "Open vSwitch" "Open vSwitch Manual" |
01ca1bfc EJ |
7 | . |
8 | .SH NAME | |
9 | \fBovs\-vlan\-test\fR \- check Linux drivers for problems with vlan traffic | |
10 | . | |
11 | .SH SYNOPSIS | |
12 | \fBovs\-vlan\-test\fR [\fB\-s\fR | \fB\-\-server\fR] \fIcontrol_ip\fR \fIvlan_ip\fR | |
13 | .so lib/common-syn.man | |
14 | . | |
15 | .SH DESCRIPTION | |
0be6140a AA |
16 | The \fBovs\-vlan\-test\fR utility has some limitations, for example, it does |
17 | not use TCP in its tests. Also it does not take into account MTU to detect | |
18 | potential edge cases. To overcome those limitations a new tool was | |
19 | developed \- \fBovs\-test\fR. \fBovs\-test\fR is currently supported only | |
20 | on Debian so, if possible try to use that on instead of \fBovs\-vlan\-test\fR. | |
21 | .PP | |
01ca1bfc EJ |
22 | The \fBovs\-vlan\-test\fR program may be used to check for problems sending |
23 | 802.1Q traffic which may occur when running Open vSwitch. These problems can | |
24 | occur when Open vSwitch is used to send 802.1Q traffic through physical | |
25 | interfaces running certain drivers of certain Linux kernel versions. To run a | |
26 | test, configure Open vSwitch to tag traffic originating from \fIvlan_ip\fR and | |
27 | forward it out the target interface. Then run the \fBovs\-vlan\-test\fR in | |
28 | client mode connecting to an \fBovs\-vlan\-test\fR server. | |
29 | \fBovs\-vlan\-test\fR will display "OK" if it did not detect problems. | |
16d25518 JG |
30 | .PP |
31 | Some examples of the types of problems that may be encountered are: | |
431488e6 | 32 | .so utilities/ovs-vlan-bugs.man |
01ca1bfc EJ |
33 | . |
34 | .SS "Client Mode" | |
35 | An \fBovs\-vlan\-test\fR client may be run on a host to check for VLAN | |
36 | connectivity problems. The client must be able to establish HTTP connections | |
37 | with an \fBovs\-vlan\-test\fR server located at the specified \fIcontrol_ip\fR | |
38 | address. UDP traffic sourced at \fIvlan_ip\fR should be tagged and directed out | |
39 | the interface whose connectivity is being tested. | |
40 | . | |
41 | .SS "Server Mode" | |
42 | To conduct tests, an \fBovs\-vlan\-test\fR server must be running on a host | |
43 | known not to have VLAN connectivity problems. The server must have a | |
44 | \fIcontrol_ip\fR on a non\-VLAN network which clients can establish | |
45 | connectivity with. It must also have a \fIvlan_ip\fR address on a VLAN network | |
46 | which clients will use to test their VLAN connectivity. Multiple clients may | |
47 | test against a single \fBovs\-vlan\-test\fR server concurrently. | |
48 | . | |
49 | .SH OPTIONS | |
50 | . | |
91005f03 BP |
51 | .IP "\fB\-s\fR" |
52 | .IQ "\fB\-\-server\fR" | |
01ca1bfc EJ |
53 | Run in server mode. |
54 | . | |
55 | .so lib/common.man | |
56 | .SH EXAMPLES | |
57 | Display the Linux kernel version and driver of \fBeth1\fR. | |
58 | .IP | |
59 | .B uname \-r | |
60 | .IP | |
61 | .B ethtool \-i eth1 | |
62 | . | |
63 | .PP | |
64 | Set up a bridge which forwards traffic originating from \fB1.2.3.4\fR out | |
65 | \fBeth1\fR with VLAN tag 10. | |
66 | .IP | |
67 | .B ovs\-vsctl \-\- add\-br vlan\-br \(rs | |
68 | .IP | |
69 | .B \-\- add\-port vlan\-br eth1 \(rs | |
70 | .IP | |
71 | .B \-\- add\-port vlan\-br vlan\-br\-tag tag=10 \(rs | |
72 | .IP | |
73 | .B \-\- set Interface vlan\-br\-tag type=internal | |
74 | .IP | |
29f53796 | 75 | .B ifconfig vlan\-br\-tag up 1.2.3.4 |
01ca1bfc EJ |
76 | . |
77 | .PP | |
78 | Run an \fBovs\-vlan\-test\fR server listening for client control traffic on | |
29f53796 | 79 | 172.16.0.142 port 8080 and VLAN traffic on the default port of 1.2.3.3. |
01ca1bfc | 80 | .IP |
29f53796 | 81 | .B ovs\-vlan\-test \-s 172.16.0.142:8080 1.2.3.3 |
01ca1bfc EJ |
82 | . |
83 | .PP | |
29f53796 EJ |
84 | Run an \fBovs\-vlan\-test\fR client with a control server located at |
85 | 172.16.0.142 port 8080 and a local VLAN ip of 1.2.3.4. | |
01ca1bfc | 86 | .IP |
29f53796 | 87 | .B ovs\-vlan\-test 172.16.0.142:8080 1.2.3.4 |
01ca1bfc | 88 | . |
01ca1bfc EJ |
89 | .SH SEE ALSO |
90 | . | |
91 | .BR ovs\-vswitchd (8), | |
92 | .BR ovs\-ofctl (8), | |
93 | .BR ovs\-vsctl (8), | |
0be6140a | 94 | .BR ovs\-test (8), |
01ca1bfc EJ |
95 | .BR ethtool (8), |
96 | .BR uname (1) |