Contents

iPerf commands· 1

iperf 1

 

iPerf commands

This feature is supported only on the following interfaces:

·     All interfaces on MSR810-LM-EA.

·     Cellular interfaces on MSR3610-X1/MSR2600-15-X1/MSR2600-15-X1-XS installed with 4G/5G interface modules.

iperf

Use iperf to test the network bandwidth from the device to an iPerf server.

Syntax

iperf [ ipv6 ] [ host host [ port port-number ] ] [ interface interface-type interface-number ] *

Views

User view

Predefined user roles

network-admin

Parameters

ipv6: Specifies the IPv6 network. If you do not specify this keyword, the command tests the network bandwidth from the device to an iPerf server on the IPv4 network.

host host: Specifies the IP address or host name of an iPerf server. The host name is a case-insensitive string of 1 to 253 characters that can contain letters, digits, hyphens (-), underscores (_), and dots (.). To use a default iPerf server, do not specify this option.

port port-number: Specifies a port by its number. The value range for the port-number argument is 1 to 65535, and the default is 5201. To avoid test failure, make sure the specified port is the same as that configured on the iPerf server.

interface interface-type interface-number: Specifies a source interface for iPerf packets by its type and number. If you do not specify this option, the system looks up the routing table or forwarding table based on the destination IP address for an interface to send iPerf packets.

Usage guidelines

Application scenarios

Use this command to test the network bandwidth from the device to an iPerf server so that users can identify whether the network bandwidth meets service requirements.

Operating mechanism

After you execute this command, the device establishes a TCP connection with the iPerf server and continuously tests the average bandwidth within 1 second at 1-second intervals for 10 times. It displays the number of transmitted bytes and average bandwidth in the outbound direction for each test, and the average inbound and outbound bandwidths within 10 seconds.

If you do not specify the IP address or host name of an iPerf server, the device uses a default iPerf server for network bandwidth testing as follows:

1.     The device pings the default iPerf servers.

2.     The device preferentially selects the default iPerf server with the minimum hops for network bandwidth testing.

3.     If the test fails, the device selects the next server with the minimum hops from the default iPerf server list for testing until a test succeeds or all tests fail.

The default iPerf servers supported by the device are open public iPerf servers used worldwide. Table 1 shows the information (including the region, domain name, and service port number range) about the default iPerf servers.

Table 1 Default iPerf servers supported by the device

Region	Domain name	Port number range
Asia	iperf.biznetnetworks.com	5201 to 5203
	speedtest.uztelecom.uz	5200 to 5209
America	iperf.he.net	5201
Europe	ping.online.net	5200 to 5209
	iperf.astra.in.ua	5201 to 5206
Oceania	speedtest-iperf-akl.vetta.online	5200 to 5209

 

Restrictions and guidelines

To avoid test failure, make sure the specified iPerf server supports the iPerf protocol.

To perform an iPerf test by using the host name of an iPerf server, you must first configure DNS on the device.

Examples

# On the IPv4 network, test the network bandwidth from the device to the iPerf server at 10.1.1.2.

<Sysname> iperf host 10.1.1.2

Press CTRL_C to break

Connecting to host 10.1.1.2, port 5201

Local 10.1.1.1 port 64065 connected to 10.1.1.2 port 5201

Interval(sec)   Transfer      Bitrate

 0.00-1.00      12.6 MBytes    106 Mbps

 1.00-2.00      16.1 MBytes    135 Mbps

 2.00-3.00      11.6 MBytes   97.0 Mbps

 3.00-4.00       8.92 MBytes  74.8 Mbps

 4.00-5.00      11.4 MBytes   95.8 Mbps

 5.00-6.00      13.7 MBytes    115 Mbps

 6.00-7.00       9.32 MBytes  78.2 Mbps

 7.00-8.00      13.6 MBytes    114 Mbps

 8.00-9.00      11.5 MBytes   96.2 Mbps

 9.00-10.00     11.4 MBytes   95.5 Mbps

Summary:

Interval(sec)    Transfer      Bitrate       Direction

 0.00-10.00       120 MBytes    101 Mbps     Outbound

 0.00-10.00       120 MBytes    101 Mbps     Inbound

# On the IPv4 network, test the network bandwidth from the device to a default iPerf server.

<Sysname> iperf

Press CTRL_C to break

Selecting the best server based on ping...

Trying to start a bandwidth test with server speedtest.uztelecom.uz on port 5200...

Failed to run iperf client: error - unable to connect to server: Connection refused

Trying to start a bandwidth test with server speedtest.uztelecom.uz on port 5201...

Connecting to host 10.1.1.2, port 5201

Local 10.1.1.1 port 64070 connected to 10.1.1.2 port 5201

Interval(sec)   Transfer      Bitrate

 0.00-1.00      12.8 MBytes    108 Mbps

 1.00-2.00      14.7 MBytes    123 Mbps

 2.00-3.00      12.0 MBytes    101 Mbps

 3.00-4.00      10.6 MBytes   88.6 Mbps

 4.00-5.00      12.3 MBytes    103 Mbps

 5.00-6.00      10.8 MBytes   90.3 Mbps

 6.00-7.00      12.0 MBytes    101 Mbps

 7.00-8.00       9.83 MBytes   82.4 Mbps

 8.00-9.00      10.9 MBytes   91.8 Mbps

 9.00-10.00     13.4 MBytes    113 Mbps

Summary:

Interval(sec)   Transfer      Bitrate       Direction

 0.00-10.00      119 MBytes    100 Mbps     Outbound

 0.00-10.00      119 MBytes    100 Mbps     Inbound

Table 2 Command output

Field	Description
Press CTRL_C to break	To stop the iPerf test, press Ctrl+C.
Selecting best server based on ping...	The device pings the default iPerf servers in the default iPerf server list, and then preferentially selects the one with the minimum hops for network bandwidth testing.
Trying to start a bandwidth test with server speedtest.uztelecom.uz on port 5200...	The device tries to test the network bandwidth from itself to the selected public iPerf server.
Connecting to host 10.1.1.2, port 5201	The IP address and port number of the connected iPerf server are 10.1.1.2 and 5201, respectively.
Local 10.1.1.1 port 64065 connected to 10.1.1.2 port 5201	A network bandwidth test connection has been established. This field also shows the IP addresses and port numbers of the client and server.
Interval	Start time and end time of a test interval.
Transfer	Number of transmitted bytes, in bytes, Kbytes, Mbytes, Gbytes, or Tbytes. The device automatically adjusts the unit based on the test result.
Bitrate	Packet transmission rate, in bps, Kbps, Mbps, Gbps, or Tbps. The device automatically adjusts the unit based on the test result.
Direction	Packet direction: ·     Outbound. ·     Inbound.
Summary	Summary information in the test intervals.

 

# On the IPv6 network, test the network bandwidth from the device to the iPerf server at 10:1::1:2.

<Sysname> iperf ipv6 host 10:1::1:2

Press CTRL_C to break

Connecting to host 10:1::1:2, port 5201

Local 10:1::1:1 port 64065 connected to 10:1::1:2 port 5201

Interval(sec)   Transfer      Bitrate

 0.00-1.00      12.6 MBytes    106 Mbps

 1.00-2.00      16.1 MBytes    135 Mbps

 2.00-3.00      11.6 MBytes   97.0 Mbps

 3.00-4.00       8.92 MBytes  74.8 Mbps

 4.00-5.00      11.4 MBytes   95.8 Mbps

 5.00-6.00      13.7 MBytes    115 Mbps

 6.00-7.00       9.32 MBytes  78.2 Mbps

 7.00-8.00      13.6 MBytes    114 Mbps

 8.00-9.00      11.5 MBytes   96.2 Mbps

 9.00-10.00     11.4 MBytes   95.5 Mbps

Summary:

Interval(sec)   Transfer      Bitrate       Direction

 0.00-10.00      120 MBytes    101 Mbps     Outbound

 0.00-10.00      120 MBytes    101 Mbps     Inbound

# On the IPv6 network, test the network bandwidth from the device to a default iPerf server.

<Sysname> iperf ipv6

Press CTRL_C to break

Selecting the best server based on ping...

Trying to start a bandwidth test with server speedtest.uztelecom.uz on port 5200...

Failed to run iperf client: error - unable to connect to server: Connection refused

Trying to start a bandwidth test with server speedtest.uztelecom.uz on port 5201...

Connecting to host 10:1::1:2, port 5201

Local 10:1::1:1 port 64070 connected to 10:1::1:2 port 5201

Interval(sec)   Transfer      Bitrate

 0.00-1.00      12.8 MBytes    108 Mbps

 1.00-2.00      14.7 MBytes    123 Mbps

 2.00-3.00      12.0 MBytes    101 Mbps

 3.00-4.00      10.6 MBytes   88.6 Mbps

 4.00-5.00      12.3 MBytes    103 Mbps

 5.00-6.00      10.8 MBytes   90.3 Mbps

 6.00-7.00      12.0 MBytes    101 Mbps

 7.00-8.00       9.83 MBytes  82.4 Mbps

 8.00-9.00      10.9 MBytes   91.8 Mbps

 9.00-10.00     13.4 MBytes    113 Mbps

Summary:

Interval(sec)   Transfer      Bitrate       Direction

 0.00-10.00      119 MBytes    100 Mbps     Outbound

 0.00-10.00      119 MBytes    100 Mbps     Inbound

Table 3 Command output

Field	Description
Press CTRL_C to break	To stop the iPerf test, press Ctrl+C.
Selecting best server based on ping...	The device pings the default iPerf servers in the default iPerf server list, and then preferentially selects the one with the minimum hops for network bandwidth testing.
Trying to start a bandwidth test with server speedtest.uztelecom.uz on port 5200...	The device tries to test the network bandwidth from itself to the selected public iPerf server.
Connecting to host 10:1::1:2, port 5201	The IP address and port number of the connected iPerf server are 10:1::1:2 and 5201, respectively
Local 10:1::1:1 port 64065 connected to 10:1::1:2 port 5201	A network bandwidth test connection has been established. This field also shows the IP addresses and port numbers of the client and server.
Interval	Start time and end time of a test interval.
Transfer	Number of transmitted bytes, in bytes, Kbytes, Mbytes, Gbytes, or Tbytes. The device automatically adjusts the unit based on the test result.
Bitrate	Packet transmission rate, in bps, Kbps, Mbps, Gbps, or Tbps. The device automatically adjusts the unit based on the test result.
Direction	Packet direction: ·     Outbound. ·     Inbound.
Summary	Summary information in the test intervals.