utilities/ovs-l3ping.8.in

   1 .de IQ
   2 .  br
   3 .  ns
   4 .  IP "\\$1"
   5 ..
   6 .TH ovs\-l3ping 1 "June 2012" "Open vSwitch" "Open vSwitch Manual"
   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)