How to: Add an Agent to a Controller
You can use a group of computers to generate simulated load for testing. This group of computers consists of a single controller and one or more agents, which are collectively called a rig.
After you have completed the setup for both your controller and agents, you can administer the rig through the controller. Apart from indicating that your test should run on a rig, most of the management of a rig is considered an administrative function that is not typically performed by rig users. For more information, see How to: Administer a Rig.
Before you can administer the rig, you must add one or more agents to the controller. The most common way to add an agent to a controller is by running agent setup. Agent setup will automatically contact the controller and add the agent.
The following procedures explain how to add and remove agents from a controller.
Adding an Agent to a Controller
To add an agent to a controller
On the Test menu in Visual Studio, click Administer Test Controllers to display the Administer Test Controller dialog box.
In the Controller drop-down combo box, type the name of the computer on which you have set up the controller. If you have administered a specific controller previously, you can select the name from the list.
Note
You can also administer agents from this dialog box. For more information, see How to: Administer a Rig.
Click Add to add an agent to the rig.
Note
The Add command is used if you have removed an agent from a controller, but have not uninstalled the agent software. You can then add it back to the controller using the Add command.
After an agent is added, configure it in the Agents section of the dialog box.
Warning
If the agent is currently configured to run on another controller, you must reconfigure the agent to use the new controller. The Administer Test Controllers dialog box does not do this for you. You must run the agentconfigutil.exe file located in the agent folder to reconfigure the agent.
Removing an Agent from a Controller
To remove an agent from a controller
On the Test menu in Visual Studio, click Administer Test Controllers to display the Administer Test Controller dialog box.
In the Controller drop-down combo box, enter the name of the computer on which you have set up the controller.
Select the agent name listed in the Agents pane and then click Remove.
Note
Removing an agent just disassociates it from the controller. To completely uninstall the agent, use Add or Remove Programs from Control Panel on the agent computer.
You cannot move an agent to another controller by using the Administer Test Controllers dialog box. To move an agent to another controller, delete the agent from its current controller, uninstall the agent, and finally reinstall the agent. When you reinstall the agent, specify the new controller.
See Also
Tasks
How to: Run a Load Test Using Agents
Concepts
Setting Up the Controller and Agent Functionality
Test Rig Requirements for Team System