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:
- From the Windows Control Panel, double-click Administrative
Tools. Then double-click Services.
- In the Services window, double-click IBM Rational Agent
Controller to open its property sheet.
- 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:
- From the Windows Control Panel, double-click System to
open its property sheet.
- On the property sheet, click Advanced.
Click Environment Variables.
- In the System variables table select the Path variable.
Click Edit.
- 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.
- Click OK and OK again.
You can now run the Agent Controller configuration utility:
- Open a DOS command prompt window.
- Navigate to the Agent Controller bin directory. For example: cd
C:\Program Files\IBM\SDP70Shared\AgentController\bin.
- Enter SetConfig and press the Enter key.
- 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.
- 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.
- 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.
- Accept the default values on the remaining prompts.
Now that the Agent Controller is configured properly,
start it by performing the following steps:
- In the DOS prompt window, navigate to the Agent Controller bin
directory. For example: cd C:\Program Files\IBM\SDP70\AgentController\bin.
- Enter ACServer to start the Agent Controller
process.