Export (0) Print
Expand All

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

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

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

  2. 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>
    
  3. 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

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

  2. 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>
    
  3. 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>
    
Show:
© 2014 Microsoft