IBM Support

How to configure the connection or session timeout in async

Question & Answer


Question

How to configure the connection or session timeout in async

Answer

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 asyncs 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 asyncs 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 asyncs 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 asyncs 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 youve made your configurations. After editing run the following validation command to ensure you havent 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
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSHH7W","label":"IBM Aspera Sync"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

More support for:
IBM Aspera Sync

Software version:
All Version(s)

Document number:
746539

Modified date:
24 April 2020

UID

ibm10746539

Manage My Notification Subscriptions