Configuring the Agent Controller (Windows)

This topic describes how to configure the Agent Controller on Windows to enable remote execution of configured test cases.

Before you begin

Before you can configure the Agent Controller, you must install it. The Rational Performance Tester installation procedure installs the Agent Controller and lets you configure it, so you should not have to perform any additional configuration steps for that testing tool. This topic applies if you use Rational Functional Tester, or Rational Robot. See the Help topic, Working with the Agent Controller in the testing tool Help for additional information.

Before configuring the Agent Controller, check to see if it is running as a system service. The Agent Controller service name is IBM Rational Agent Controller (ACWinService.exe). If the Agent Controller is running as a system service, stop it before performing configuration steps.

About this task

You must have Administrator privileges to stop the Agent Controller system service. To stop the Agent Controller system service, perform the following steps:
  1. From the Windows Control Panel, double-click Administrative Tools. Then double-click Services.
  2. In the Services window, double-click IBM Rational Agent Controller to open its property sheet.
  3. In the Startup type field, select Manual from the drop-down list. Click Stop. Click OK.
You must edit your PATH environment variable to include the path to the Java Runtime Environment (JRE) installed on the computer. Perform the following steps to edit your PATH environment variable:
  1. From the Windows Control Panel, double-click System to open its property sheet.
  2. On the property sheet, click Advanced. Click Environment Variables.
  3. In the System variables table select the Path variable. Click Edit.
  4. If the path to the JRE is not already in the Variable value field, add it to the end of the value. Use a semicolon to separate the new path from the last path in the value. For example: ;C:\Program Files\IBM\RFT70\jdk\jre\bin.
  5. Click OK and OK again.
You can now run the Agent Controller configuration utility:
  1. Open a DOS command prompt window.
  2. Navigate to the Agent Controller bin directory. For example: cd C:\Program Files\IBM\SDP70Shared\AgentController\bin.
  3. Enter SetConfig and press the Enter key.
  4. The configuration utility displays the following prompt: Specify the fully qualified path of "java.exe". The default value is the path to the JRE installed with the testing product. Press the Enter key to accept the default path shown, or enter another path and press the Enter key. For Rational Functional Tester, the JRE version must be the same JRE version that was used to compile the test scripts associated with the configured test cases that you plan to execute on the remote computer.
  5. The configuration utility displays the following prompt: Network access mode (ALL=allow any host, LOCAL=allow only this host, CUSTOM=list of hosts). The default value is LOCAL. Enter ALL and press the Enter key to allow any ClearQuest Test Manager client to execute configured test cases on this computer.
  6. The configuration utility displays the following prompt: Security enabled. (true/false). The default value is FALSE. The Security enabled option is not currently supported. Press the Enter key to accept the default value.
  7. Accept the default values on the remaining prompts.
Now that the Agent Controller is configured properly, start it by performing the following steps:
  1. In the DOS prompt window, navigate to the Agent Controller bin directory. For example: cd C:\Program Files\IBM\SDP70\AgentController\bin.
  2. Enter ACServer to start the Agent Controller process.

What to do next


Feedback