Configuration des ports pour les contrôleurs de test et des agents de test

Publication: juillet 2016

Vous pouvez modifier les ports entrants par défaut utilisés par le contrôleur de test, l'agent de test et le client. Cela peut s'avérer nécessaire si vous essayez d'utiliser le contrôleur de test, l'agent de test ou le client avec un autre logiciel qui entre en conflit avec les paramètres de port. Une autre raison motivant le changement de ports est la restriction de pare-feu entre le contrôleur de test et le client. Dans ce cas, vous pouvez configurer manuellement le port pour l'activer pour un pare-feu afin que le contrôleur de test puisse envoyer des résultats au client.

L'illustration suivante montre les points de connexion entre le contrôleur de test, l'agent de test et le client. Elle décrit les ports utilisés pour les connexions entrantes et sortantes ainsi que les restrictions de sécurité sur ces ports.

La technologie utilisée pour connecter des composants d'exécution de test distants est .NET Remoting sur des ports TCP. Pour plus d'informations, voir .NET Remoting.

• Connexions entrantes   Le port par défaut utilisé par le contrôleur de test est 6901 et le port par défaut de l'agent de test est 6910. Le client utilise un port aléatoire par défaut qui est utilisé pour recevoir les résultats de test du contrôleur de test. Pour toutes les connexions entrantes, le contrôleur de test authentifie l'abonné appelant et vérifie s'il appartient à un groupe de sécurité spécifique.

  • Contrôleur de test   Les connexions entrantes s'effectuent sur le port TCP 6901. Si cela s'avère nécessaire, vous pouvez configurer le port entrant. Pour plus d'informations, consultez Configuration des ports entrants.

    Le contrôleur de test doit être en mesure d'établir la connexion sortante vers les agents de test et le client.

    Notes

    Le contrôleur de test a besoin d'une connexion Partage de fichiers et d'imprimantes entrante ouverte.

  • Agent de test   Les connexions entrantes s'effectuent sur le port TCP 6910. Si cela s'avère nécessaire, vous pouvez configurer le port entrant. Pour plus d'informations, consultez Configuration des ports entrants.

    L'agent de test doit être en mesure d'établir une connexion sortante vers le contrôleur de test.

  • Client   Par défaut, un port TCP aléatoire est utilisé pour les connexions entrantes. Si cela s'avère nécessaire, vous pouvez configurer le port entrant. Pour plus d'informations, consultez Configuration des ports entrants.

    Vous pouvez obtenir des notifications de pare-feu lorsque le contrôleur de test essaie de se connecter au client pour la première fois.

    Sur Windows Server 2008 les notifications de pare-feu sont désactivées par défaut et vous devez ajouter manuellement des exceptions de pare-feu pour les programmes clients (devenv.exe, mstest.exe, mlm.exe) afin que le programme accepte les connexions entrantes.

• Connexions sortantes   Les ports TCP aléatoires sont utilisés pour toutes les connexions sortantes.

  • Contrôleur de test   Le contrôleur de test doit être en mesure d'établir la connexion sortante vers les agents et le client.

  • Agent de test   L'agent de test doit être en mesure d'établir une connexion sortante vers le contrôleur.

  • Client   Le client doit être en mesure d'établir la connexion sortante vers le contrôleur.

Pour plus d'informations, notamment sur les problèmes de sécurité des contrôleurs de test et des agents de test, voir le guide de résolution des problèmes liés au contrôleur et à l'agent de test Visual Studio.

Configuration des ports entrants

Suivez les instructions ci-après pour configurer les ports d'un contrôleur de test et des agents de test.

• Service de contrôleur   Modifiez la valeur du port en modifiant le fichier <lettre de lecteur:>\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\QTCcontroller.exe.config :

  <appSettings>
    <add key="ControllerServicePort" value="6901"/>
  </appSettings>
  

• Service de l'agent Modifiez le port en modifiant le fichier <lettre de lecteur:>\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\QTAgentService.exe.config :

  <appSettings>
    <add key="AgentServicePort" value="6910"/>
  </appSettings>
  

• Client   Utilisez l'éditeur du registre pour ajouter les valeurs de registre suivantes (DWORD). Le client utilisera l'un des ports de la plage spécifiée pour la réception des données envoyées par le contrôleur de test :

  HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\VisualStudio\12.0\EnterpriseTools\QualityTools\ListenPortRange\PortRangeStart

  HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\VisualStudio\12.0\EnterpriseTools\QualityTools\ListenPortRange\PortRangeEnd

Voir aussi

Installation et configuration des agents de test et des contrôleurs de test