Microsoft KB Archive/944496

= How to bind a controller or an agent to a specific network adapter when multiple network adapters exist on the same computer =

Article ID: 944496

Article Last Modified on 12/7/2007

-

APPLIES TO


 * Microsoft Visual Studio 2005 Team System Test Edition

-



INTRODUCTION
When you run Microsoft Visual Studio 2005 Team System Test Controller or Visual Studio 2005 Team System Test Agent on a computer that has multiple network adapters, the controller or the agent must bind to a specific network adapter. A network adapter can be bound to the computer that is running Visual Studio 2005, to the computer that is running the controller, or to the computer that is running the agent. This article describes how to bind a test controller and a test agent to a specific network adapter.



MORE INFORMATION
To bind a controller or an agent to a specific network adapter, update the following test run configuration files:
 * QTAgentService.exe.config
 * QTAgent.exe.config
 * QTController.exe.config

These configuration files are located in the installation folder of the agent or of the controller. For example, the QTAgent.exe file is located in the following folder:



When you install the controller or the agent on a computer that has multiple network adapter cards, you must specify the IP address of the controller or of the agent instead of the computer name. This configuration applies to the controller, to the agent service, and to the agent process.

For example, to bind a controller to a network adapter by updating the QTController.exe.config file, follow these steps.

Note You can use this same method to update the QTAgentService.exe.config file and the QTAgent.exe.config file.   Stop the controller service. To do this, run the following command at a command prompt: net stop vsttcontroller  In Notepad, open the QTController.exe.config file. This file is located in the installation folder of the controller.  In the QTController.exe.config file, add an entry for the BindTo property of the application settings (). Specify the IP address of the network adapter that you want to bind the controller to. For example, the code may resemble the following:        <add key=&quot;BindTo&quot; value=&quot;<YOUR IP ADDRESS>&quot; /> </appSettings> Note The BindTo property must be set for each process that is running on a computer that has more than one network adapter. </li> Save the QTController.exe.config file.</li>  Start the controller service. To do this, run the following command at a command prompt: net start vsttcontroller </li></ol>

After you bind the controller to the network adapter, run the agent installation to connect an agent to the bound controller.

Note You must install the following hotfix if you want to bind the computer that is running Visual Studio 2005 to a network adapter.

939819 FIX: You cannot bind a test computer that is running Visual Studio Team System to a specific network adapter if the test computer has multiple network adapters

For complete instructions about how to install the test controller and the test agent, visit the following Microsoft Developer Network (MSDN) Web site:

http://blogs.msdn.com/edglas/pages/load-agent-and-load-controller-installation-and-configuration-guide.aspx

Keywords: kbhowto KB944496

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.