You are here: Home Experiment Information US ATLAS Grid Operations Iperf rpms Installation and setup

Installation and setup

by dkat — last modified Sep 06, 2007 02:30 PM
Instructions for installing and setting up iperf daemons

1. The binary rpm needs to be installed:

$ rpm -Uvh iperf-2.0.2-rhel4.0.5.racf.2.i386.rpm

Then configured:
- If the site needs to change the listening port, then edit the init script: /etc/init.d/iperf and change these two lines:

IPERF_TCP_OPTS="-s -w 4M -p 20000"
IPERF_UDP_OPTS="-s -u -p 20000"

Substitute port number 20000 with the port number of preference.

Note: the -D (daemon) switch does not work as intended with iperf 2.0.2 (bug).
In TCP mode the daemon comes up but does not respond to clients.
In UDP mode the daemon fails to report the server stats to the client at the end of a test.
The script starts both iperf servers as background processes.
These processes behave as daemons, but without the -D issues.

To start the daemons simply do:

$ /etc/init.d/iperf start

Usage:

/etc/init.d/iperf {start|stop|restart|status}

To make it so the iperf daemons run automatically at boot time, do:

$ chkconfig --add iperf

2. If the binary rpm is not compatible with the host's OS, use the source rpm to build a custom binary rpm:

$ rpmbuild --rebuild iperf-2.0.2-rhel4.0.5.racf.2.src.rpm

Then simply follow the instructions above for installing and configuring the resulting binary rpm.

Note: When the rpm is installed, it will modify the system's kernel parameters in /etc/sysctl.conf to increase the network buffers, but ONLY if the sysadmin has not already set their own parameters. The settings it uses are:

net.core.wmem_max = 4194304
net.core.rmem_max = 4194304
net.core.wmem_default = 131072
net.core.rmem_default = 131072
net.ipv4.tcp_wmem = 4096 65536 4194304
net.ipv4.tcp_rmem = 8192 131072 4194304
net.core.netdev_max_backlog = 10000
Document Actions