Set the transfer recovery timeout for all transfers for one source agent

We can set a transfer recovery timeout that applies to all the transfers for a source agent by adding the transferRecoveryTimeout parameter to the agent.properties file.

About this task

To set a treansfer recovery timeout that applies to all the transfers for a source agent, you add the parameter and value pair for the transferRecoveryTimeout to the agent.properties file.

There are three options for the transferRecoveryTimeout parameter:

-1

The agent continues to attempt to recover the stalled transfer until the transfer is successful. Using this option is the equivalent of the default behavior of the agent when the property is not set.

0

The agent stops the file transfer as soon as it enters recovery.

>0

The agent continues to attempt to recover the stalled transfer for the amount of time in seconds as set by the positive integer value specified.

Any changes that you make to the agent.properties file come into effect only after the agent is restarted.

If required, we can override the transfer recovery timeout value in the agent.properties file for an individual transfer. For more information, see Set the transfer recovery timeout for individual transfers.

Procedure

• To specify that the agent continues to try to recover the stalled transfer until it completes successfully, set a transfer recovery timeout value of -1 as shown in the following example:

  transferRecoveryTimeout=-1

• To specify that the agent marks the transfer as failed immediately upon entering recovery, set a transfer recovery timeout value of 0 as shown in the following example:

  transferRecoveryTimeout=0

• To specify that the agent keeps retrying a stalled transfer for a given amount of time before the transfer is marked as failed, set a transfer recovery timeout value for the amount of time, in seconds, that we want to agent to keep retrying. For example, setting a transfer recovery timeout value of 21600 means that the agent keeps trying to recover the transfer for six hours from when it enters recovery:

  transferRecoveryTimeout=21600

  The maximum value for this parameter is 999999999.

Parent topic: Set a timeout for recovery of stalled transfers