Bandwidth configuration

The Bandwidth configuration options include target transfer rates, transfer policies, and assigning Vlinks to control aggregate bandwidth usage.

  1. Open the application with root privileges.
  2. Click Configuration > Bandwidth.

  3. Edit Global , Groups, and Users settings on their Bandwidth tabs. Select Override in the option's row to set an effective value. User settings take precedence over group settings, which take precedence over global settings.

Bandwidth settings reference

Field Description Values Default
Incoming Vlink ID The ID of the Vlink to apply to incoming transfers.

Vlinks are a way to define aggregate transfer policies. For more information, see Controlling bandwidth usage with virtual links from the command line.

 Vlink IDs Undefined (Disabled)
Incoming Target Rate Cap (Kbps) The maximum target rate for incoming transfers, in kilobits per second.

No transfer session can exceed this rate at any time. If the client requests an initial rate greater than the target rate cap, the transfer proceeds at the target rate cap. The default setting of unlimited applies no target rate cap.

 positive integer unlimited
Incoming Target Rate Default (Kbps) The default initial rate for incoming transfers, in kilobits per second.

If allowed, Incoming Target Rate Lock is set to false, clients can modify this rate in real time. This setting is not relevant to transfers with a fixed bandwidth policy.

 positive integer 10000
Incoming Target Rate Lock Lock the target rate of incoming transfers.
  • true - Locks the target rate of incoming transfers.
  • false - Allow users to adjust the transfer rate of an incoming transfer up to the Incoming Target Rate Cap.
true or false false
Incoming Minimum Rate Cap (Kbps) The highest minimum rate that an incoming transfer can request, in kilobits per second.

Client minimum rate requests that exceed the minimum rate cap are ignored. The default value of unlimited applies no cap to the minimum rate.

 positive integer or unlimited unlimited
Incoming Minimum Rate Default (Kbps) The default initial minimum rate for incoming transfers, in kilobits per second.

If allowed, Incoming Minimum Rate Lock is set to false and clients can modify the minimum rate in real time, up to the Incoming Minimum Rate Cap.

This setting is not relevant to transfers with a fixed bandwidth policy.

 positive integer 0
Incoming Minimum Rate Lock Lock the minimum rate of incoming transfers.
  • true - Locks the minimum rate of incoming transfers.
  • false - Allow users to adjust the minimum transfer rate up to the Incoming Minimum Rate Cap.

This setting is not relevant to transfers with a fixed bandwidth policy.

 true or false false
Incoming Bandwidth Policy Allowed The bandwidth policies that incoming transfers can use. These policies transfers can use high, fair, low, or fixed bandwidth policies to determine bandwidth allocation among transfers.
  • any - The server does not deny any transfer based on policy setting.
    Note: Setting to any allow clients to request a fixed bandwidth policy. If the client also requests a high minimum transfer rate and that is not capped by the server, the transfer rate can exceed network or storage capacity. This can decrease transfer performance and cause problems on the target storage. To avoid these problems, set the allowed policy to fair.
  • high - Transfers that use high, fair, or low bandwidth policies are allowed. Transfers that request fixed bandwidth policy are rejected.
  • fair - Transfers that use fair or low bandwidth policies are allowed. Transfers that request fixed bandwidth policy are rejected.
  • low - Only transfers that use a low bandwidth policy are allowed. All others are rejected.
 high, fair, low, or any any
Incoming Bandwidth Policy Default The default bandwidth policy for incoming transfers.

Clients can override the default policy if they specify a policy allowed by the server. See Incoming Bandwidth Policy Allowed and if Incoming Bandwidth Policy Lock is set to false.

  • high - Adjust the transfer rate to fully use the available bandwidth up to the maximum rate. When congestion occurs, the transfer rate is twice as fast as a fair-policy transfer. The high policy requires maximum (target) and minimum transfer rates.
  • fair - Adjust the transfer rate to fully use the available bandwidth up to the maximum rate. When congestion occurs, bandwidth is shared fairly by transferring at an even rate. The fair policy requires maximum (target) and minimum transfer rates.
  • low - Adjust the transfer rate to use the available bandwidth up to the maximum rate. Similar to fair mode, but less aggressive when the bandwidth is shared with other network traffic. When congestion occurs, the transfer rate is reduced to the minimum rate until other traffic decreases.
  • fixed - Attempt to transfer at the specified target rate, regardless of network or storage capacity. This can decrease transfer performance and cause problems on the target storage. Use the fixed policy only for specific contexts, such as bandwidth testing, otherwise, avoid the use of this policy. The fixed policy requires a maximum target rate.
  • aggressiveness - The aggressiveness of transfers that are authorized by this access key in claiming available bandwidth. Value can be 0.00-1.00. For example, these values correspond to the policy option where a policy of high approximates to aggressiveness of 0.75, fair to 0.50 and low to 0.25. Aggressiveness can be used if you need to fine-tune the transfer policy.
 high, fair, low, fixed fair
Incoming Bandwidth Policy Lock Lock the bandwidth policy of incoming transfer sessions.
  • true - Locks the bandwidth policy of incoming transfer sessions.
  • false - Allow users to adjust the bandwidth policy.
 true or false false
Incoming Rate Control Module
Set how the transmission rate should be managed relative to instantaneous network bandwidth availability. This option can be changed only by advanced users.

When the client does not specify a configuration, the server configuration is used. When the client specifies a value other than delay and the client is the receiver, then the client configuration overrides the server configuration.

Values:

  • delay - The baseline rate control module used by the transfers.
  • delay-odp - A queue-scaling controller for overdrive protection.
  • delay-adv - An advanced rate controller.
  • delay-laq - A loss-adjusted queuing (LAQ) rate controller.
    Note: The LAQ module is an experimental rate control module that is designed to solve issues with target rate overdrive, high concurrency when many FASP® sessions run at the same time, and shallow buffers so that the limited packet queuing capability of a router. When LAQ is set, then it uses the FD31 RTT predictor unless a different RTT predictor is explicitly set.

To set a rate control module for outgoing traffic, set it from the command line. See aspera.conf - Transfer configuration.

 delay, delay-odp, delay-adv, or delay-laq delay
Incoming Traffic RTT Predictor The type of predictor to use to compensate for feedback delay when measuring RTT.

An experimental feature that might increase transfer rate stability and throughput by predicting network congestion. When set to unset, the client specified predictor is used and if the client does not specify a predictor, then none is used. For more information, see Increasing transfer performance by using an RTT Predictor.

 unset, none, alphabeta, fd31, bezier, ets unset
Incoming Rate Control Target Queue The method for calculating the target queue.

For more information, see Increasing transfer performance by using an RTT Predictor.

  • unset - The transfer queuing is not specified, therefore, the static transfer queuing is used.
  • static- Specified transfer queuing is good for most internet connections.
  • dynamic- Specified transfer queuing is good for satellite and other radio connections.
 unset, static, dynamic unset
Outgoing Vlink ID The ID of the vlink to apply to outgoing transfers. Vlinks are a way to define aggregate transfer policies. For more information, see Controlling bandwidth usage with virtual links from the command line. Vlink ID Undefined (Disabled)
Outgoing Target Rate Cap (Kbps) The maximum target rate for outgoing transfers, in kilobits per second.

No transfer session can exceed this rate at any time. If the client requests an initial rate greater than the target rate cap, the transfer proceeds at the target rate cap. The default setting of unlimited applies no target rate cap.

 positive integer unlimited
Outgoing Target Rate Default (Kbps) The default initial rate for outgoing transfers, in kilobits per second.

If allowed, Outgoing Target Rate Lock is set to false, therefore, clients can modify this rate in real time up to the Outgoing Target Rate Cap.

This setting is not relevant to transfers with a fixed bandwidth policy.		 positive integer 10000
Outgoing Target Rate Lock Lock the target rate of outgoing transfers.
  • true - Locks the target rate of outgoing transfers.
  • false - Allow users to adjust the transfer rate of an outgoing transfer.
 true or false false
Outgoing Minimum Rate Cap (Kbps) The highest minimum rate that an outgoing transfer can request, in kilobits per second.

Client minimum rate requests that exceeds the minimum rate cap are ignored. The default value of unlimited applies no cap to the minimum rate.

 positive integer unlimited
Outgoing Minimum Rate Default The default initial minimum rate for outgoing transfers, in kilobits per second.

If allowed, Outgoing Minimum Rate Lock is set to false, clients can modify the minimum rate in real time up to the Outgoing Minimum Rate Cap.

This setting is not relevant to transfers with a fixed bandwidth policy.

 positive integer 0
Outgoing Minimum Rate Lock Lock the minimum rate of outgoing transfers.
  • true - Locks the minimum rate of outgoing transfers to the default value.
  • false - Allow users to adjust the minimum transfer rate.
This setting is not relevant to transfers with a fixed bandwidth policy.		 true or false false
Outgoing Bandwidth Policy Allowed The bandwidth policies that outgoing transfers can use. Transfers can use high, fair, low, or fixed bandwidth policies to determine bandwidth allocation among transfers.
  • any - The server does not deny any transfer based on policy setting.
    Note: Setting to any allow clients to request a fixed bandwidth policy. If the client also requests a high minimum transfer rate and that is not capped by the server, the transfer rate can exceed network or storage capacity. This can decrease transfer performance and cause problems on the target storage. To avoid these problems, set the allowed policy to fair.
  • high - Transfers that use high, fair, or low bandwidth policies are allowed. Transfers that request fixed bandwidth policy are rejected.
  • fair - Transfers that use fair or low bandwidth policies are allowed. Transfers that request fixed bandwidth policy are rejected.
  • low - Only transfers that use a low bandwidth policy are allowed. All others are rejected.
 high, fair, low, or any any
Outgoing Bandwidth Policy Default The default bandwidth policy for outgoing transfers. Clients can override the default policy if they specify a policy allowed by the server (see Outgoing Bandwidth Policy Allowed) and if Outgoing Bandwidth Policy Lock is set to false.
  • high - Adjust the transfer rate to fully use the available bandwidth up to the maximum rate. When congestion occurs, the transfer rate is twice as fast as a fair-policy transfer. The high policy requires maximum (target) and minimum transfer rates.
  • fair - Adjust the transfer rate to fully use the available bandwidth up to the maximum rate. When congestion occurs, bandwidth is shared fairly by transferring at an even rate. The fair policy requires maximum (target) and minimum transfer rates.
  • low - Adjust the transfer rate to use the available bandwidth up to the maximum rate. Similar to fair mode, but less aggressive when the bandwidth is shared with other network traffic. When congestion occurs, the transfer rate is reduced to the minimum rate until other traffic decreases.
  • fixed - Attempt to transfer at the specified target rate, regardless of network or storage capacity. This can decrease transfer performance and cause problems on the target storage. Use the fixed policy only for specific contexts, such as bandwidth testing, otherwise, avoid the use of this policy. The fixed policy requires a maximum target rate.
  • aggressiveness - The aggressiveness of transfers that are authorized by this access key in claiming available bandwidth. Value can be 0.00-1.00. For example, these values correspond to the policy option where a policy of high approximates to aggressiveness of 0.75, fair to 0.50 and low to 0.25. Aggressiveness can be used if you need to fine-tune the transfer policy.
 high, fair, low, fixed fair
Outgoing Bandwidth Policy Lock Lock the bandwidth policy of outgoing transfer sessions.
  • true - Locks the bandwidth policy of outgoing transfer sessions.
  • false - Allow users to adjust the bandwidth policy
 true or false false
Outgoing Traffic RTT Predictor The type of predictor to use to compensate for feedback delay when measuring RTT.

An experimental feature that might increase transfer rate stability and throughput by predicting network congestion. When set to unset, the client specified predictor is used and if the client does not specify a predictor, then none is used. For more information, see Increasing transfer performance by using an RTT Predictor.

 unset, none, alphabets, fd3, bezier, ets unset
Outgoing Rate Control Target Queue The method for calculating the target queue.

For more information, see Increasing transfer performance by using an RTT Predictor.

  • unset - The transfer queuing is not specified, therefore, the static transfer queuing is used.
  • static- Specified transfer queuing is good for most internet connections.
  • dynamic- Specified transfer queuing is good for satellite and other radio connections.
 unset,static, dynamic unset