Specifying a time varying schedule for a Vlink


Upon creating a virtual link (Vlink), which is an aggregate bandwidth limit, it is sometimes useful to further specify a schedule to vary the virtual link capacities according to the time of day and/or day of the week. For example, at peak hours for your server you might want to lower the bandwidth limit on your transfers, and increase the limit at slower times of the day.

The easiest way of specifying a time varying schedule for a Vlink is to do this in Aspera Console. See this article for more details.

If you do not have Aspera Console please see below for further instructions on how to set the time varying schedule manually. The following assumes you have access to your Aspera Server or Point-to-Point, and have already defined one or more Vlinks. For more information on how to create a Vlink, see this article.


STEP 1 - Locate your aspera.conf configuration file

This type of configuration cannot be done from the application GUI and therefore must be performed by editing the aspera.conf configuration file. For the exact location please see the product documentation. The locations for the most common operating systems are the following:

  • Linux: /opt/aspera/etc
  • Windows: C:\Program Files (x86)/Aspera/product_name/etc (replace product_name with your installed product)
  • Mac: /Library/Aspera/etc

Before proceeding to edit the aspera.conf file, make a backup copy.

STEP 2 - Locate the Vlink configuration within aspera.conf

When you create one or more Vlinks (whether through the GUI or through the command line) the configuration for the Vlink is added to the aspera.conf file. Each Vlink is identified by an ID, which is a number between 1 and 255, and a name. These are both configured when setting up the Vlink.

Your aspera.conf file will have one or more <trunk> sections. Please locate the <trunk> section corresponding to the Vlink you wish to change the configuration for. Below is an example of a Vlink with ID 1 and the name "Default":

<schedule format="ranges">2000</schedule>

STEP 3 - Specify Vlink capacities

A time varying schedule for a Vlink consists of a default capacity and one or more capacities that apply within a specific time frame. Please note that the time and day specified relate to the local time of your server.

A time varying schedule must have a start and an end time, and specify the days in which the capacity applies. Outside of the specified time frame the default capacity applies.

Edit the <schedule> section of your Vlink by adding:

  • the start time (in 24 clock time)
  • the end time (in 24 clock time)
  • the days in a comma-delimited list
  • the capacity for the time frame
  • the default capacity

Below is an example specifying a Vlink capacity of 1Mbps (1000kbps) from 07 to 19 every weekday, and for all other times the capacity is 5Mbps (5000kbps):

<schedule format="ranges">start=07 end=19 days=mon,tue,wed,thu,fri capacity=1000;capacity=5000</schedule>

Please note times specified can only be whole hours, so "19" is allowed but "1930" is not. 

It is also possible to specify more than one time varying schedule. In the example below a capacity of 1Mbps is required on Monday and Tuesday and a capacity of 5Mbps is required on Wednesday, Thursday and Friday. At any other time, the capacity is set to 10Mbps:

<schedule format="ranges">start=07 end=19 days=mon,tue capacity=1000;start=09 end=18 days=wed,thu,fri capacity=5000;capacity=10000</schedule>
Powered by Zendesk