Iperf

Description

Iperf (http://iperf.sourceforge.net/) is a network tool that measures bandwidth available between two endpoints. NetBeez's agents can run tests between agents or between an agent and another Iperf server. Iperf reports bandwidth in Mbps, delay jitter in milliseconds and datagram loss. Iperf can send both TCP and UDP traffic. TCP based tests generate as much bandwidth as the NetBeez agent can generate (between 80 and 85 Mbps), while UDP based tests require that the user specify the desired bandwidth value.

NetBeez offers two types of Iperf testing, scheduled and ad-hoc.

Scheduled Iperf Tests

With NetBeez, Iperf tests can be configured and scheduled to run at a user-defined interval.  On the Iperf Tab under Tests, you can view existing Iperf tests or add a new one.

Scheduled Iperf Details

To view the details of a specific scheduled Iperf test, click on the corresponding table entry on the Iperf Tab.  This will launch the Scheduled Iperf Details.

The Scheduled Iperf Details displays current and historical data about the test.  In the first panel, the visual slider displays aggregate performance data about the test over time and serves as a means to access information on past test runs.  For Iperf, the slider’s metrics include Bandwidth, Packet Loss, and Jitter (if UDP)  The default selection is the most recent test run.  The second panel displays per-agent performance information about the selected test run.  Upon clicking on an agent from the list of agents in the test, a third panel will open, which displays the historical data of that particular agent over time.

Setting Up a Scheduled Iperf Test

To create a new scheduled Iperf Test, click the Add Scheduled Iperf Test entry on the Iperf Tab.  Follow these steps to configure your test:

  1. Select Source Agents and Destination Server on which the test will be conducted.  The agents act as the transmitters and the destination server acts as the receiver.
  2. Configure the test settings.
    1. Select the Test Type (TCP or UDP)
      1. TCP: Will send as much bandwidth as the agent can generate. The TCP test parameters are:
        1. Server port (optional): The destination TCP port that traffic should be sent to. By default, TCP port 5001 is used.
        2. Test duration (optional): The duration, expressed in seconds, of the bandwidth test. The default value is 10 seconds. Please be aware that the test cannot be stopped during its execution.
        3. Result interval (optional): The interval between two consecutive outputs of the bandwidth test running. The default value is 1 second.
        4. TCP window size (optional): The size of the TCP window expressed in MB. By default, this value is 1 MB.
      2. UDP: Will send the user-specified bandwidth. The UDP test parameters are:
        1. Server port (optional): The destination TCP port that traffic should be sent to. By default TCP 5001 is used.
        2. Test duration (optional): The duration expressed in second of the bandwidth test. The default value is 10 seconds. Please be aware that whatever value it is selected, the test cannot be stopped during its execution.
        3. Result interval (optional): The interval between two consecutive outputs of the bandwidth test running. The default value is 1 second.
        4. UDP bandwidth (optional): The bandwidth that the source agent should generate. Be default, this value is set to 10 Mbps. Please keep in mind that the NetBeez agents can generate 80 to 85 Mbps of traffic.
    2. Check whether to use Multicast Iperf
      1. Multicast group address (required): The multicast group address that the two endpoints should exchange.
      2. TTL (optional): The Time To Live of the multicast packets.
    3. TOS DSCP/PHB Class (optional): The DSCP value to apply to the Iperf traffic.
  3. Schedule the test
    1. If you want the test to run at a regular interval, select the Periodic scheduling option.  
      1. Input a number and select the time unit (minutes, hours, days, and weeks).  
      2. Optionally, you can choose to set the interval start time.  If you do not set the interval start time, the test will first run upon saving and creating the scheduled Iperf test.
    2. If you need greater control over when and how often the test runs, select the Custom scheduling option.
      1. Select the time at which the test is to run.  If you need the test to run at an additional time (e.g. at 2:00 AM and again at 8:00 AM), click the Plus button to access additional time input fields.
      2. Choose whether you would like the test to run daily or on select days, in which case, check which days.
  4. Click Save

Ad-Hoc Iperf Tests

In addition to scheduled Iperf tests, The NetBeez dashboard also offers ad-hoc Iperf testing via the Ad-Hoc Testing Tab.

To run an ad-hoc Iperf test:

  1. On the Ad-Hoc Testing Tab, select Iperf from the test options.
  2. Input the following fields:
    1. Source (required): The source agent that will send traffic.
    2. Destination (required): The destination agent that will receive traffic.
    3. Test type (required): The transport protocol.
      1. TCP: Will send as much as the agent is able to generate. The TCP test based parameters are:
        1. Server port (optional): The destination TCP port that traffic should be sent to. By default, TCP 5001 is used.
        2. Test duration (optional): The duration, expressed in seconds, of the bandwidth test. The default value is 10 seconds. Please be aware that the test cannot be stopped during its execution.
        3. Result interval (optional): The interval between two consecutive outputs of the bandwidth test running. The default value is 1 second.
        4. TCP window size (optional): The size of the TCP window expressed in MB. By default, this value is 1 MB.
      2. UDP: Will send the user-specified bandwidth. The UDP test based parameters are:
        1. Server port (optional): The destination TCP port that traffic should be sent to. By default TCP 5001 is used.
        2. Test duration (optional): The duration expressed in second of the bandwidth test. The default value is 10 seconds. Please be aware that whatever value it is selected, the test cannot be stopped during its execution.
        3. Result interval (optional): The interval between two consecutive outputs of the bandwidth test running. The default value is 1 second.
        4. UDP bandwidth (optional): The bandwidth that the source agent should generate. Be default, this value is set to 10 Mbps. Please keep in mind that the NetBeez agents can generate 80 to 85 Mbps of traffic.
    4. Click on the Multicast IPerf checkbox and define:
      1. Multicast group address (required): The multicast group address that the two endpoints should exchange.
      2. TTL (optional): The Time To Live of the multicast packets.
    5. TOS DSCP/PHB Class (optional): The DSCP value to apply to the Iperf traffic.
Click Run to start the Iperf test.  Results will be displayed to the right.
Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk