About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
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 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 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 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 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"}}]
Was this topic helpful?
Document Information
Modified date:
24 April 2020
UID
ibm10746539
Manage My Notification Subscriptions