How to configure the connection or session timeout in async

IN THIS ARTICLE:

Instructions:

Description

When there is an issue with async establishing a connection with a remote endpoint, async terminates after a given amount of time. This can happen if you are experiencing high latency on SSH, for example. This termination would also occur in the case that async has established a connection, but the session has become unresponsive.

By default, the timeout for async to wait before terminating is 20 seconds. If you would like to give async more time to establish a connection or to wait for an unresponsive session, you can configure the timeout period to one of your choice.

Instructions

You can configure the timeout periods through the command line using the tool asconfigurator, which modifies the main configuration file aspera.conf file for you. Alternatively, you can also modify aspera.conf yourself directly, though you must be particularly careful with this method.

via asconfigurator

In order to configure async’s timeout period for establishing a connection, run the following command, where time is the time period in seconds:

asconfigurator -x "set_node_data;async_connection_timeout_sec,time" 

For example, if you want async to wait 75 seconds to establish a connection before terminating, you would run the following:

asconfigurator -x "set_node_data;async_connection_timeout_sec,75"

To configure async’s timeout period for an unresponsive session, run the following command, where time is the time period in seconds:

asconfigurator -x "set_node_data;async_session_timeout_sec,time"

For example, if you want async to wait one minute for an unresponsive session before terminating, you would run the following:

asconfigurator -x "set_node_data;async_session_timeout_sec,60"

via aspera.conf

Open the following file in a text editor:

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

The timeout configurations go in the <default> section.

To configure async’s timeout period for establishing a connection, add the following within the <default> section, where time is the time period in seconds:

<async_connection_timeout_sec>time</async_connection_timeout_sec>

To configure async’s timeout period for an unresponsive session, add the following within the <default> section, where time is the time period in seconds:

<async_session_timeout_sec>time</async_session_timeout_sec>

As a sample, your <default> section might look something like the following. In this example, we configure async to wait 50 seconds to establish a connection before terminating, and 70 seconds for an unresponsive session:

<default>
    <async_connection_timeout_sec>50</async_connection_timeout_sec>
    <async_session_timeout_sec>70</async_session_timeout_sec
</default>

Save the aspera.conf file once you’ve made your configurations. After editing, run the following validation command to ensure you haven’t made any mistakes in aspera.conf:

Mac OS X
/Library/Aspera/bin/asuserdata -v

Windows
"C:\Program Files (x86)\Aspera\Enterprise Server\bin\asuserdata" -v

Linux
/opt/aspera/bin/asuserdata -v

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk