How to: Specify Timeout Periods for Test Controllers and Test Agents

Article
02/04/2013

Both the test controller and the test agent have several timeout settings that specify how long they should wait for responses from one another, or from a data source before failing with an error. Under certain circumstances, it might be necessary to edit the timeout values to meet the needs of your topology or other environment issues. To edit the timeout values, edit the XML configuration file that is associated with either the test controller or test agent, as covered in the following procedures.

To edit a test controller or a test agent’s various timeout settings, modify the following configuration files using the key names and values in the tables:

Test controller: QTController.exe.config

Key name	Description	Value
AgentConnectionTimeoutInSeconds	Number of seconds to wait for agent ping request before connection is considered lost.	"n" seconds.
AgentSyncTimeoutInSeconds	When you start a synchronizing test run, number of seconds to wait for all agents to sync before aborting the run.	"n" seconds.
AgentInitializeTimeout	Number of seconds to wait for all agents and their data collectors to initialize at the beginning of a test run, before aborting the test run. This value should be reasonably large if using data collectors.	"n" seconds. Default: "120" (two minutes).
AgentCleanupTimeout	Number of seconds to wait for all agents and their data collectors to clean up, before completing the test run. This value should be reasonably large if using data collectors.	"n" seconds. Default: "120" (two minutes).

Test Agent: QTAgentService.exe.config

Key name	Description	Value
ControllerConnectionPeriodInSeconds	Number of seconds between attempts to connect to the controller.	"n" seconds. Default: "30" (thirty seconds).
RemotingTimeoutSeconds	Maximum time a remoting call can last in seconds.	"n" seconds. Default: "600" (ten minutes).
StopTestRunCallTimeoutInSeconds	Number of seconds to wait for call to stop the test run.	"n" seconds. Default: "120" (two minutes).
GetCollectorDataTimeout	Number of seconds to wait for the data collector.	"n" seconds. Default: "300" (five minutes).

To Specify Agent Timeout Options for a Test Controller

Open the QTCcontroller.exe.config XML configuration file located in <drive letter:>\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\.

locate <appSettings> tag.

  <appSettings>
    <add key="LogSizeLimitInMegs" value="20"/>
    <add key="AgentConnectionTimeoutInSeconds" value="120"/>
    <add key="AgentSyncTimeoutInSeconds" value="300"/>
    <add key="ControllerServicePort" value="6901"/>
    <add key="ControllerUsersGroup" value="TeamTestControllerUsers"/>
    <add key="ControllerAdminsGroup" value="TeamTestControllerAdmins"/>
    <add key="CreateTraceListener" value="no"/>
  </appSettings>

Edit an existing value for one of the test controller’s timeout keys. For example, you can change the default value for the key AgentConnectionTimeoutInSeconds from two minutes to three minutes:
```
    <add key="AgentConnectionTimeoutInSeconds" value="180"/>
```
-or-

Add an additional key and specify a timeout value. For example, you can add the AgentInitializeTimeout key in the <appSettings> section and specify a value of five minutes:
```
    <add key="AgentInitializeTimeout" value="300"/>
  </appSettings>
```

To Specify Agent Timeout Options for a Test Agent

Open the QTAgentService.exe.config XML configuration file located in <drive letter:>\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\.

locate <appSettings> tag.

  <appSettings>
    <appSettings>
    <add key="LogSizeLimitInMegs" value="20"/>
    <add key="AgentServicePort" value="6910"/>
    <add key="ControllerConnectionPeriodInSeconds" value="30"/>
    <add key="StopTestRunCallTimeoutInSeconds" value="120"/>
    <add key="CreateTraceListener" value="no"/>
    <add key="GetCollectorDataTimeout" value="300"/>
  </appSettings>  </appSettings>

Edit an existing value for one of the test agent’s timeout keys. For example, you can change the default value for the key ControllerConnectionPeriodInSeconds from thirty seconds to one minute:
```
    <add key="ControllerConnectionPeriodInSeconds" value="60"/>
```
-or-

Add an additional key and specify a timeout value. For example, you can add the RemotingTimeoutSeconds key in the <appSettings> section and specify a value of fifteen minutes:
```
    <add key=" RemotingTimeoutSeconds " value="900"/>
  </appSettings>
```

How to: Specify Timeout Periods for Test Controllers and Test Agents

To Specify Agent Timeout Options for a Test Controller

To Specify Agent Timeout Options for a Test Agent

See Also

Tasks

Concepts

Other Resources

Additional resources