Install Rational Performance Tester Agent

+

Search Tips   |   Advanced Search

Overview

The RPT Agent includes...

• Rational Agent Controller
• Data collection infrastructure

The Rational Agent Controller executes user load on remote locations.

On client machines...

• Install Rational Agent Controller using the Installation Manager.
• Install IBM Rational License Server.
• Import the floating license key into the license server on the workbench machine.
• Refer remote machines to the license server.

On workbench machine...

• Configure the test schedule to run tests remotely.
• Run tests with user loads of 100, 500, 1000, and 2000.

On Windows, Rational Agent Controller is installed as a service...

Example: Install on AIX

See also: Installing Rational Performance Tester 8.1 Agent Controller on an AIX workstation

1. Uninstall previous versions of Agent Controller:

   • If Agent Controller 7.0 or 6.x is found, the Agent Controller v8.0 installer will block the installation with a warning:
     Please remove any existing Rational Agent Controller and run the install again

     When using the silent installer, the Agent Controller v8.0 installer will exit the installation without any warning.

   • If a previous installation of Agent Controller v8.0 is found, the installer displays the following warning:
     This product is already installed at <rac_install_dir>.

     To overwrite the existing installation, click Next.

     If you choose to continue with the installation, the installer will overwrite the existing installation. When using the silent installer, the existing installation will be overwritten without any warning.

   On AIX platforms, manually remove any residual files...

   1. Stop the Agent Controller

   2. Uninstall it
      /opt/IBM/AgentController/_uninst
      ./uninstall.bin -silent

      Agent Controller v8.1 prevents multiple instances of RPTv8 from being installed on a single workstation. When additional installations are performed, either as a stand-alone installation or as an embedded installation inside a product, Agent Controller records a reference to the name of RPTv8 that is initiating the new installation.

      If Agent Controller has been installed multiple times, it can be uninstalled only when the last referencing product is uninstalled; the last referencing product still requires Agent Controller.

      If you attempt to uninstall Agent Controller while it is still required by another product, the uninstallation will not proceed and you will receive a message...

      This product cannot be uninstalled as it is required by another product

   3. Clean up any of the following files which may be left behind after uninstalling:
      $RASERVER_HOME/*
      /usr/lib/libLogAgent.so
      /usr/lib/libhcbnd.so
      /usr/lib/libhcclco.so
      /usr/lib/libhccldt.so
      /usr/lib/libhccls.so
      /usr/lib/libhcclserc.so
      /usr/lib/libhcclsert.so
      /usr/lib/libhcclsm.so
      /usr/lib/libhcjbnd.so
      /usr/lib/libhclaunch.so
      /usr/lib/libhcthread.so

2. Set environment variables...

   PATH=/path/to/java/jre/bin:$PATH
   export PATH
   LIBPATH=/path/to/java/jre/bin:/path/to/java/jre/bin/classic:$LIBPATH
   export LIBPATH

3. Verify the Java version...
   java -fullversion

4. Log in as Administrator (or root).

5. Change directory to the directory where you unzipped the installation files for the appropriate platform.

6. Close all Eclipse platforms before continuing with the installation.

7. Run...
   setup.bin

8. Click Next on the welcome screen to proceed.

9. Specify the path where Agent Controller should be installed and click Next to proceed.

10. Specify the path of the JRE executable program java.exe or java which Agent Controller should be using.

    The JRE entered here will be used by Agent Controller for launching Java applications. Therefore, you may want to change the JRE path pre-filled by the installer program.

    The JRE you provide at this time will be used both to run Agent Controller and for Agent Controller to launch Java applications. You may, however, later configure Agent Controller to a use separate JRE for each of these functions.

    Click Next to proceed.

11. Specify the version of IBM WAS if "Remote Support for WAS" was selected in step 9 above.

    Click Next to proceed.

12. Specify the paths of IBM WAS version 5.0 (Windows only) and 5.1 if "Remote Support for WebSphere Application Server" was selected in step 9 above.

    Click Next to proceed.

13. Specify which hosts can access Agent Controller.

    For RPT, select Specific computers.

    Click Next to proceed.

14. Accept the default value (Disable) for the security setting.

    Click Next to proceed.

15. Click Next on the summary screen to install Agent Controller.

16. Click Finish after the installation has completed.

Start the Agent Controller on AIX

On AIX, the Agent Controller process (RAServer) does not start automatically. You must start it yourself.

For certain JVMs, the LDR_CNTRL environment variable needs to be set to USERREGS to work properly with the Agent Controller.

To set this variable, run the following command before running the RAStart.sh script:

export LDR_CNTRL=USERREGS

To start the Agent Controller process...

cd /opt/IBM/AgentController/bin
./RAStart.sh

To stop the Agent Controller process...

cd /opt/IBM/AgentController/bin
./RAStop.sh