projects / ovs.git / blame
| 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) |