====== Iperf ======

**General Information**

iperf allows testing of network throughput. It requires you to install iperf on a source and destination system. 

**Checklist**
  * Distro(s): Enterprise Linux 6

----

====== Install iperf ======

  * Add the [[linux_wiki:repos#epel|EPEL repo]].
  * Install iperf on the "client" and "server" system.<code bash>yum install iperf</code>

----

====== Performance Test ======

**Note:** Transfers are from client to server, ie: upload transfer. (Unless doing bi-directional tests)
  * The client transfers data to the server, and the server throws away the data.

\\
  * Start iperf on the "server" system.<code bash>iperf -s</code>
    * Specify what port iperf listens on with the '-p <port>' option.<code bash>iperf -s -p 1337</code>
    * Specify an address for iperf to listen on (-B for bind) - useful if you ened to specify a 10 Gb interface<code bash>iperf -s -B 10.0.0.1 -p 1337</code>
  * Run the test from the client
    * Basic test with default settings<code bash>iperf -c <server-ip></code>
    * Basic test, specify server listening port<code bash>iperf -c <server-ip> -p 1337</code>
    * Bi-directional test<code bash>iperf -c <server-ip> -p 1337 -d</code>
    * Custom Test: Bandwidth format in MBytes/sec (-f M), show max segment size and MTU (-m), pause 2 seconds in between reports (-i 2), transmit for 30 seconds (-t 30).<code bash>iperf -c <server-ip> -p 1337 -f M -m -i 2 -t 30</code>

----