KBEC-00302 - Configure retry times and retry interval when commander agent saves step output

Article ID:360032827952
1 minute readKnowledge base


When executing a step, commander agent records output from the commands of the step to the step log file. During the execution of a step, commander agent does the following steps:

  1. Creates the step log file in the workspace

  2. Appends output from step commands to and save the step log file (this step happens multiple times in case the output is big)

  3. Close the step log file

Commander agent relies on the file service of the operating system in the above steps. It is possible that the operating system returns errors when commander agent invokes file service system calls. Here’re two example cases:

  1. The step log file is deleted accidentally, so the operating system cannot find the step log file anymore

  2. The workspace is in a network shared folder and the network is temporarily down

In such a case, commander agent retries the file service system 10 times in 500 millisecond intervals. Commander agent reports error and fails the step if all retries failed.


The retry times and retry interval is configurable. You can add the following two lines in the agent configuration file (/conf/agent/wrapper.conf) and set desired value.


Applies to

  • Product version: 4.1.x and later

  • OS versions: All