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 follow these steps to configure your test:

  1. Go to the Tests tab.
  2. Click on the Iperf sub-tab.
  3. Click the "Add Scheduled Iperf Test" button.
  4. Name: Assign a name to the iperf scheduled test.
  5. Assign Agents/Destination Server
    1. Select the type of test:
      1. One-to-one: This is an iperf test between two NetBeez agents.
      2. Multiple agents to destination server: The is an Iperf test running between many NetBeez agents and one Iperf server that is not managed by the NetBeez dashboard itself.
        Please note: This type of test is not supported in Iperf version 3.
    2. If you selected the one-to-one test type, the following options will appear:
      1. Select Source Agent: Select the iperf sender, which is a NetBeez agent.
      2. Select Destination Agent: Select the iperf receiver, which is a NetBeez agent.
    3. If you selected the multiple agents to destination server test type, the following options will appear:
      1. Source Agents: Select the Iperf senders, which are the NetBeez agents that will send traffic to the server.
      2. Select Destination Server: This is an Iperf server that is not managed by the NetBeez dashboard.
  6. Configure Test: Here select the Iperf configuration settings, including Test Type. Based on what protocol you selected, different configuration options will be enabled.
    1. TCP: The TCP test will send as much bandwidth as the agent can generate. The TCP test parameters are:
      1. Server port (required): The destination TCP port that traffic should be sent to. By default, TCP port 5001 is used.
      2. Test duration (required): The duration, expressed in seconds, of the bandwidth test. By default, this value is set to 10 seconds. Please be aware that the test cannot be stopped during its execution.
      3. Parallel streams (required): This is the number of parallel connections, or streams, that will be run between the sender(s) and receiver.
      4. TCP window size (optional): The size of the TCP window expressed in MB. By default, this value is 1 MB.
      5. TOS DSCP/PHB Class: If enabled, the IP packets will be marked with a user-defined Type of Service. By default, no ToS value is set on Iperf IP packets. 
      6. Iperf version (required): Select the Iperf version used. By default, version 2 is selected.
        Note: Please be aware that supported features differ between Iperf versions 2 and 3. For example, the many-to-one option is not supported by Iperf version 3. 
    2. UDP: The UDP test will send the user-specified bandwidth. The UDP test parameters are:
      1. Multicast: Only available on the UDP protocol (multicast is UDP), this test will run a multicast stream from the source agent (multicast sender) to the destination agent (multicast server). If enabled, you will need to specify these additional settings:
        1. Multicast group address (required): The multicast group address used for the multicast test.
        2. TTL (optional): The Time To Live of the multicast packets.
      2. Server port (optional): The destination TCP port to which traffic should be sent. By default TCP 5001 is used.
      3. 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.
      4. Parallel streams (required): This is the number of parallel connections, or streams, that will be run between the sender(s) and receiver.
      5. 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.
      6. TOS DSCP/PHB Class: If enabled, the IP packets will be marked with a user-defined Type of Service. By default, no ToS value is set on Iperf IP packets. 
      7. Iperf version (required): Select the Iperf version used. By default, version 2 is selected.
        Note: Please be aware that supported features differ between Iperf versions 2 and 3. For example, the many-to-one option is not supported by Iperf version 3. 
  7. Schedule Test
    1. Use the scheduling interface to set at what times and how frequently the test will run.
      Note: Be sure to double check the schedule you have entered.
  8. 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. Fill out the following fields:
    1. Source (required): The agent that will send traffic.
    2. Destination (required): The agent that will receive traffic.
    3. Test type (required): The transport protocol.  The options are TCP and UDP:
      1. TCP: Will send as much as the agent is able to generate. The TCP test based parameters are:
        1. Iperf version (required): Select the Iperf version used. By default, version 2 is selected.
          Note:
          Please be aware that supported features differ between Iperf versions 2 and 3. For example, the many-to-one option is not supported by Iperf version 3.
        2. Server port (optional): The destination TCP port that traffic should be sent to. By default, TCP 5001 is used.
        3. 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.
        4. Result interval (optional): The interval between two consecutive outputs of the bandwidth test running. The default value is 1 second.
        5. TCP window size (optional): The size of the TCP window expressed in MB. By default, this value is 1 MB.
        6. Parallel streams (required): This is the number of parallel connections, or streams, that will be run between the sender(s) and receiver.
        7. TOS DSCP/PHB Class: If enabled, the IP packets will be marked with a user-defined Type of Service. By default, no ToS value is set on Iperf IP packets. 
      2. UDP: Will send the user-specified bandwidth. The UDP test based parameters are:
        1. Multicast Iperf: Only available on the UDP protocol (multicast is UDP), this test will run a multicast stream from the source agent (multicast sender) to the destination agent (multicast server). If enabled, you will need to specify these additional settings:
          1. Multicast group address (required): The multicast group address used for the multicast test.
          2. TTL (optional): The Time To Live of the multicast packets.
        2. Iperf version (required): Select the Iperf version used. By default, version 2 is selected.
          Note:
          Please be aware that supported features differ between Iperf versions 2 and 3. For example, the many-to-one option is not supported by Iperf version 3.
        3. Server port (optional): The destination TCP port that traffic should be sent to. By default TCP 5001 is used.
        4. 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.
        5. Result interval (optional): The interval between two consecutive outputs of the bandwidth test running. The default value is 1 second.
        6. Parallel streams (required): This is the number of parallel connections, or streams, that will be run between the sender(s) and receiver.
        7. 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.
        8. TOS DSCP/PHB Class: If enabled, the IP packets will be marked with a user-defined Type of Service. By default, no ToS value is set on Iperf IP packets. 
  3. Click Run.  The results will appear to the right.
Have more questions? Submit a request

0 Comments

Article is closed for comments.