Optional Tosca Distribution Agent configurations

You can change most Agent settings in the Tosca Distribution Monitor (see chapter "Monitor, recover, and configure Agents in the Tosca Distributed Execution Monitor").

Additionally, you can modify the following settings in the configuration files:

Change workspace log detail

Tosca Distributed Execution writes all activities that concern the Agent itself into the Agent log. You can configure this log in the Tosca Distribution Monitor (see chapter "Logging tab").

If you use Tosca Distributed Execution without AOS, you have an additional log: the workspace log. The workspace log records all workspace activities of the Agent.

You can find the log file Log_<date_number>.txt in the workspace folder.

The available detail range of the workspace log is 4 to 12. A value of 4 provides you with the least detailed log, a value of 12 with a detailed log of all your updates.

By default, the value is set to 4.

To change the workspace log level, follow the steps below:

  1. Stop the Agent.

  2. On the Agent machine, open the ToscaDistributionAgent.exe.config file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution.

  3. In the userSettings section, enter a new value for LogLevel.

  4. If you also want to modify the RDP timeout setting, you can do so now.

  5. If you are done with your configurations, perform the following actions:

Example: log level 6

<userSettings>
  <Tricentis.DistributionServer.Properties.Settings>
  ...
    <setting name="LogLevel" serializeAs="String">
      <value>6</value>
    </setting>
  ...
  </Tricentis.DistributionServer.Properties.Settings>
</userSettings>

Set a custom RDP port

The Agent needs an inbound port for the RDP connection. The default port for Remote Desktop on Windows is 3389.

If you have specified a different port for Remote Desktop on Windows, you must also change this port in your Agent configuration. You have to do this on every Agent machine where you have set a different port for Remote Desktop on Windows.

To do so, follow the steps below:

  1. Stop the Agent.

  2. On the Agent machine, open the ToscaRdpServer.exe.config file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution\Rdp.

  3. In the applicationSettings section, enter a new value for RdpListeningPort.

  4. If you also want to modify the RDP connection retry setting, you can do so now.

  5. If you are done with your configurations, perform the following actions:

Example: Set port 4444

<applicationSettings>
    <Tricentis.RdpServer.Properties.Settings>
        [...]
        <setting name="RdpListeningPort" serializeAs="String">
            <value>4444</value>
        </setting>
        [...]
    </Tricentis.RdpServer.Properties.Settings>
</applicationSettings>

Define the RDP connection timeout

At run-time, the Agent tries to establish an RDP connection for 30000 milliseconds (30 seconds). If it isn't successful within that time frame, the Agent aborts.

You can change that time frame. Note that you have to do this on every Agent machine that needs a different time frame.

To change the time frame, follow the steps below:

  1. Stop the Agent.

  2. On the Agent machine, open the ToscaDistributionAgent.exe.config file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution.

  3. In the userSettings section, enter a new value for EstablishRdpConnectionTimeoutMilliseconds.

  4. If you also want to modify the workspace log level setting, you can do so now.

  5. If you are done with your configurations, perform the following actions:

Example: timeout interval of 40 seconds

<userSettings>
    [...]
    <setting name="EstablishRdpConnectionTimeoutMilliseconds" serializeAs="String">
        <value>40000</value>
    </setting>
    [...]
</userSettings>

Define RDP connection retry attempts

By default, the Agent doesn't try to re-establish the connection if the RDP connection is lost.

If you log in to an Agent which is currently executing, the execution stops and can't resume. To minimize risk, you can specify that you want the Agent to try and re-establish a lost connection. Note that you have to do this on every Agent machine that should try to reconnect.

To do so, follow the steps below:

  1. Stop the Agent.

  2. On the Agent machine, open the ToscaRdpServer.exe.config file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution\Rdp.

  3. In the applicationSettings section, enter a new value for the following settings:

    • MaxConnectionRetries: enter the maximum number of retry attempts.

    • WaitBetweenRetriesMilliseconds: specify how many milliseconds the Agent should wait between tries.

  4. If you also want to modify the RDP port setting, you can do so now.

  5. If you are done with your configurations, perform the following actions:

During the retry attempt, the system logs out any active users.

So if you log in to an Agent which is trying to re-establish an RDP connection, the system will log you out shortly afterwards.

Example: 3 retries with a maximum wait of 20 seconds in between

<applicationSettings>
    <Tricentis.RdpServer.Properties.Settings>
        [...]
        <setting name="MaxConnectionRetries" serializeAs="String">
            <value>3</value>
        </setting>
        <setting name="WaitBetweenRetriesMilliseconds" serializeAs="String">
            <value>20000</value>
        </setting>
        [...]
    </Tricentis.RdpServer.Properties.Settings>
</applicationSettings>