Global Bandwidth Settings (Command Line)

In the following example, Vlink 108 is used to limit the upload bandwidth (outgoing transfers) to 88 Mbps (88000 Kbps) and Vlink 109 is used to limit the download bandwidth (incoming transfers) to 99 Mbps (99000 Kbps).

# asconfigurator -x "set_trunk_data;id,108;trunk_capacity,88000;trunk_on,true"
# asconfigurator -x "set_trunk_data;id,109;trunk_capacity,99000;trunk_on,true"
# asconfigurator -x "set_node_data;transfer_in_bandwidth_aggregate_trunk_id,108"
# asconfigurator -x "set_node_data;transfer_out_bandwidth_aggregate_trunk_id,109"

The commands create the following lines in aspera.conf.

<?xml version='1.0' encoding='UTF-8'?>
<CONF version="2">
  ...
  <trunks>
    <trunk>          <!-- Create a Vlink with 88000 Kbps bandwidth cap. -->
      <id>108</id>   <!-- ID: 108 -->
      <capacity>
        <schedule format="ranges">88000</schedule>
      </capacity>
      <on>true</on>
    </trunk>
    <trunk>          <!-- Create a Vlink with 99000 Kbps bandwidth cap. -->
      <id>109</id>   <!-- ID: 109 -->
      <capacity>
        <schedule format="ranges">99000</schedule>
      </capacity>
      <on>true</on>
    </trunk>
  </trunks>

  <default>   <!-- Global settings.-->
    <transfer>
      <out>   <!-- Use Vlink ID: 108 for global outgoing bandwidth. -->
        <bandwidth><aggregate><trunk_id>108</trunk_id></aggregate></bandwidth>
      </out>
      <in>    <!-- Use Vlink ID: 109 for global incoming bandwidth. -->
        <bandwidth><aggregate><trunk_id>109</trunk_id></aggregate></bandwidth>
      </in>
    </transfer>
  </default>
</CONF>

The capacity of the Vlink is set within a <schedule> tag because the capacity can be scheduled as one value during a specified time period, and a default value at all other times. For more information on this configuration, see the knowledge base article Specifying a time varying schedule for a Vlink at https://www.ibm.com/support/pages/specifying-time-varying-schedule-vlink.

To edit aspera.conf manually, rather than running asconfigurator commands, open the file with write permissions from the following location:

/opt/aspera/etc/aspera.conf

# /opt/aspera/bin/asuserdata -v