]>
Commit | Line | Data |
---|---|---|
2d8bdd8f AA |
1 | .de IQ |
2 | . br | |
3 | . ns | |
4 | . IP "\\$1" | |
5 | .. | |
d2cb6c95 | 6 | .TH ovs\-l3ping 1 "@VERSION@" "Open vSwitch" "Open vSwitch Manual" |
2d8bdd8f AA |
7 | . |
8 | .SH NAME | |
9 | \fBovs\-l3ping\fR \- check network deployment for L3 tunneling | |
10 | problems | |
11 | . | |
12 | .SH SYNOPSIS | |
13 | \fBovs\-l3ping\fR \fB\-s\fR \fITunnelRemoteIP,InnerIP[/mask]\fR \fB\-t\fR \fItunnelmode\fR | |
14 | .br | |
15 | \fBovs\-l3ping\fR \fB\-s\fR \fITunnelRemoteIP,InnerIP[/mask][:ControlPort]\fR \fB\-t\fR \fItunnelmode\fR | |
16 | .PP | |
17 | \fBovs\-l3ping\fR \fB\-c\fR \fITunnelRemoteIP,InnerIP[/mask],RemoteInnerIP\fR \fB\-t\fR \fItunnelmode\fR | |
18 | .br | |
19 | \fBovs\-l3ping\fR \fB\-c\fR \fITunnelRemoteIP,InnerIP[/mask][:ControlPort\ | |
20 | [:DataPort]],RemoteInnerIP[:ControlPort[:DataPort]]\fR | |
21 | [\fB\-b\fR \fItargetbandwidth\fR] [\fB\-i\fR \fItestinterval\fR] | |
22 | \fB\-t\fR \fItunnelmode\fR | |
23 | .so lib/common-syn.man | |
24 | . | |
25 | .SH DESCRIPTION | |
26 | The \fBovs\-l3ping\fR program may be used to check for problems that could | |
27 | be caused by invalid routing policy, misconfigured firewall in the tunnel | |
28 | path or a bad NIC driver. On one of the nodes, run \fBovs\-l3ping\fR in | |
29 | server mode and on the other node run it in client mode. The client and | |
30 | server will establish L3 tunnel, over which client will give further testing | |
31 | instructions. The \fBovs\-l3ping\fR client will perform UDP and TCP tests. | |
32 | This tool is different from \fBovs\-test\fR that it encapsulates XML/RPC | |
33 | control connection over the tunnel, so there is no need to open special holes | |
34 | in firewall. | |
35 | .PP | |
36 | UDP tests can report packet loss and achieved bandwidth for various | |
37 | datagram sizes. By default target bandwidth for UDP tests is 1Mbit/s. | |
38 | .PP | |
39 | TCP tests report only achieved bandwidth, because kernel TCP stack | |
40 | takes care of flow control and packet loss. | |
41 | . | |
42 | .SS "Client Mode" | |
43 | An \fBovs\-l3ping\fR client will create a L3 tunnel and connect over it to the | |
44 | \fBovs\-l3ping\fR server to schedule the tests. \fITunnelRemoteIP\fR is the | |
45 | peer's IP address, where tunnel will be terminated. \fIInnerIP\fR is the | |
46 | address that will be temporarily assigned during testing. All test traffic | |
47 | originating from this IP address to the \fIRemoteInnerIP\fR will be tunneled. | |
48 | It is possible to override default \fIControlPort\fR and \fIDataPort\fR, if | |
49 | there is any other application that already listens on those two ports. | |
50 | . | |
51 | .SS "Server Mode" | |
52 | To conduct tests, \fBovs\-l3ping\fR server must be running. It is required | |
53 | that both client and server \fIInnerIP\fR addresses are in the same subnet. | |
54 | It is possible to specify \fIInnerIP\fR with netmask in CIDR format. | |
55 | . | |
56 | .SH OPTIONS | |
57 | One of \fB\-s\fR or \fB\-c\fR is required. The \fB\-t\fR option is | |
58 | also required. | |
59 | . | |
60 | .IP "\fB\-s \fITunnelRemoteIP,InnerIP[/mask][:ControlPort]\fR" | |
61 | .IQ "\fB\-\-server\fR \fITunnelRemoteIP,InnerIP[/mask][:ControlPort]\fR" | |
62 | Run in server mode and create L3 tunnel with the client that will be | |
63 | accepting tunnel at \fITunnelRemoteIP\fR address. The socket on | |
64 | \fIInnerIP[:ControlPort]\fR will be used to receive further instructions | |
65 | from the client. | |
66 | . | |
67 | .IP "\fB\-c \fITunnelRemoteIP,InnerIP[/mask][:ControlPort\ | |
68 | [:DataPort]],RemoteInnerIP[:ControlPort[:DataPort]]\fR" | |
69 | .IQ "\fB\-\-client \fITunnelRemoteIP,InnerIP[/mask][:ControlPort\ | |
70 | [:DataPort]],RemoteInnerIP[:ControlPort[:DataPort]]\fR" | |
71 | Run in client mode and create L3 tunnel with the server on | |
72 | \fITunnelRemoteIP\fR. The client will use \fIInnerIP\fR to generate test | |
73 | traffic with the server's \fIRemoteInnerIP\fR. | |
74 | . | |
75 | .IP "\fB\-b \fItargetbandwidth\fR" | |
76 | .IQ "\fB\-\-bandwidth\fR \fItargetbandwidth\fR" | |
77 | Target bandwidth for UDP tests. The \fItargetbandwidth\fR must be given in | |
78 | bits per second. It is possible to use postfix M or K to alter the target | |
79 | bandwidth magnitude. | |
80 | . | |
81 | .IP "\fB\-i \fItestinterval\fR" | |
82 | .IQ "\fB\-\-interval\fR \fItestinterval\fR" | |
83 | How long each test should run. By default 5 seconds. | |
84 | . | |
85 | .IP "\fB\-t \fItunnelmode\fR" | |
86 | .IQ "\fB\-\-tunnel\-mode\fR \fItunnelmode\fR" | |
87 | Specify the tunnel type. This option must match on server and client. | |
88 | . | |
89 | .so lib/common.man | |
90 | . | |
91 | .SH EXAMPLES | |
92 | .PP | |
93 | On host 192.168.122.220 start \fBovs\-l3ping\fR in server mode. This command | |
94 | will create a temporary GRE tunnel with the host 192.168.122.236 and assign | |
95 | 10.1.1.1/28 as the inner IP address, where client will have to connect: | |
96 | .IP | |
97 | .B ovs\-l3ping -s 192.168.122.236,10.1.1.1/28 -t gre | |
98 | . | |
99 | .PP | |
100 | On host 192.168.122.236 start \fBovs\-l3ping\fR in client mode. This command | |
101 | will use 10.1.1.2/28 as the local inner IP address and will connect over the | |
102 | L3 tunnel to the server's inner IP address at 10.1.1.1. | |
103 | .IP | |
104 | .B ovs\-l3ping -c 192.168.122.220,10.1.1.2/28,10.1.1.1 -t gre | |
105 | . | |
106 | .SH SEE ALSO | |
107 | . | |
108 | .BR ovs\-vswitchd (8), | |
109 | .BR ovs\-ofctl (8), | |
110 | .BR ovs\-vsctl (8), | |
111 | .BR ovs\-vlan\-test (8), | |
112 | .BR ovs\-test (8), | |
113 | .BR ethtool (8), | |
114 | .BR uname (1) |