Guide pratique pour spécifier les délais d’expiration des contrôleurs de test et des agents de testHow to: Specify timeout periods for test controllers and test agents

Le contrôleur de test et l’agent de test comportent plusieurs paramètres de délai d’attente qui spécifient le délai d’attente des réponses entre eux, ou à partir d’une source de données avant de se solder par un échec avec une erreur.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. Dans certaines circonstances, il peut être nécessaire de modifier les valeurs du délai d'attente en fonction des besoins de votre topologie ou d'autres problèmes d'environnement.Under certain circumstances, it might be necessary to edit the timeout values to meet the needs of your topology or other environment issues. Pour modifier les valeurs du délai d'attente, modifiez le fichier de configuration XML associé au contrôleur de test ou à l'agent de test, comme indiqué dans les procédures suivantes.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.

Pour modifier les divers paramètres de délai d’attente d’un contrôleur de test ou d’un agent de test, modifiez les fichiers de configuration suivants à l’aide des noms de clé et des valeurs des tables :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:

  • Contrôleur de test : QTController.exe.configTest controller: QTController.exe.config

    Nom de la cléKey name DescriptionDescription ValueValue
    AgentConnectionTimeoutInSecondsAgentConnectionTimeoutInSeconds Nombre de secondes du délai d'attente de la demande de la commande ping de l'agent avant que la connexion ne soit perdue.Number of seconds to wait for agent ping request before connection is considered lost. "n" secondes."n" seconds.
    AgentSyncTimeoutInSecondsAgentSyncTimeoutInSeconds Lorsque vous démarrez une série de tests de synchronisation, nombre de secondes d’attente de la synchronisation de tous les agents avant d’abandonner l’exécution.When you start a synchronizing test run, number of seconds to wait for all agents to sync before aborting the run. "n" secondes."n" seconds.
    AgentInitializeTimeoutAgentInitializeTimeout Nombre de secondes d'attente de l'initialisation de tous les agents et de leurs collecteurs de données initialise au début de l'exécution d'un test, avant d'abandonner la série de tests.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. Cette valeur doit être raisonnablement élevée si vous utilisez des collecteurs de données.This value should be reasonably large if using data collectors. "n" secondes."n" seconds. Valeur par défaut : "120" (deux minutes).Default: "120" (two minutes).
    AgentCleanupTimeoutAgentCleanupTimeout Nombre de secondes d'attente du nettoyage de tous les agents et de leurs collecteurs de données, avant de compléter la série de tests.Number of seconds to wait for all agents and their data collectors to clean up, before completing the test run. Cette valeur doit être raisonnablement élevée si vous utilisez des collecteurs de données.This value should be reasonably large if using data collectors. "n" secondes."n" seconds. Valeur par défaut : "120" (deux minutes).Default: "120" (two minutes).
  • Agent de test : QTAgentService.exe.configTest Agent: QTAgentService.exe.config

    Nom de la cléKey name DescriptionDescription ValueValue
    ControllerConnectionPeriodInSecondsControllerConnectionPeriodInSeconds Nombre de secondes séparant deux tentatives de connexion au contrôleur.Number of seconds between attempts to connect to the controller. "n" secondes."n" seconds. Valeur par défaut : "30" (trente secondes).Default: "30" (thirty seconds).
    RemotingTimeoutSecondsRemotingTimeoutSeconds Durée maximum d'un appel à distance en secondes.Maximum time a remoting call can last in seconds. "n" secondes."n" seconds. Valeur par défaut : "600" (dix minutes).Default: "600" (ten minutes).
    StopTestRunCallTimeoutInSecondsStopTestRunCallTimeoutInSeconds Nombre de secondes d'attente l'appel de l'arrêt de la série de tests.Number of seconds to wait for call to stop the test run. "n" secondes."n" seconds. Valeur par défaut : "120" (deux minutes).Default: "120" (two minutes).
    GetCollectorDataTimeoutGetCollectorDataTimeout Nombre de secondes d'attente du collecteur de données.Number of seconds to wait for the data collector. "n" secondes."n" seconds. Valeur par défaut : "300" (cinq minutes).Default: "300" (five minutes).

Pour spécifier les options d’expiration de l’agent d’un contrôleur de testTo specify agent timeout options for a test controller

  1. Ouvrez le fichier de configuration XML QTCcontroller.exe.config qui se trouve sous %ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE.Open the QTCcontroller.exe.config XML configuration file located in %ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE.

  2. Recherchez l’étiquette <appSettings>.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. Modifiez une valeur existante pour l'une des clés de délai d'attente du contrôleur de test.Edit an existing value for one of the test controller’s timeout keys. Par exemple, vous pouvez remplacer la valeur par défaut de la clé AgentConnectionTimeoutInSeconds de 2 minutes par 3 minutes :For example, you can change the default value for the key AgentConnectionTimeoutInSeconds from two minutes to three minutes:

    <add key="AgentConnectionTimeoutInSeconds" value="180"/>
    

    - ou --or-

    Ajoutez une clé supplémentaire et spécifiez une valeur de délai d'attente.Add an additional key and specify a timeout value. Par exemple, vous pouvez ajouter la clé AgentInitializeTimeout dans la section <appSettings> et spécifier une valeur de cinq minutes :For example, you can add the AgentInitializeTimeout key in the <appSettings> section and specify a value of five minutes:

    <appSettings>
            <add key="AgentInitializeTimeout" value="300"/>
    </appSettings>
    

Pour spécifier les options d’expiration de l’agent d’un agent de testTo specify agent timeout options for a test agent

  1. Ouvrez le fichier de configuration XML QTAgentService.exe.config qui se trouve sous %ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE.Open the QTAgentService.exe.config XML configuration file located in %ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE.

  2. Recherchez l’étiquette <appSettings>.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. Modifiez une valeur existante pour l’une des clés de délai d’attente de l’agent de test.Edit an existing value for one of the test agent’s timeout keys. Par exemple, vous pouvez remplacer la valeur par défaut de la clé ControllerConnectionPeriodInSeconds de trente secondes par une minute :For example, you can change the default value for the key ControllerConnectionPeriodInSeconds from thirty seconds to one minute:

    <add key="ControllerConnectionPeriodInSeconds" value="60"/>
    

    - ou --or-

    Ajoutez une clé supplémentaire et spécifiez une valeur de délai d'attente.Add an additional key and specify a timeout value. Par exemple, vous pouvez ajouter la clé RemotingTimeoutSeconds dans la section <appSettings> et spécifier une valeur de quinze minutes :For example, you can add the RemotingTimeoutSeconds key in the <appSettings> section and specify a value of fifteen minutes:

    <appSettings>
            <add key=" RemotingTimeoutSeconds " value="900"/>
    </appSettings>
    

Voir aussiSee also