Install the Agent Controller on z/OS

Uninstall previous versions of Agent Controller

For versions of Agent Controller prior to 8.0, stop the agent and uninstall it before installing this version. You do not need to remove Agent Controller Version 8.0 or later.

Configure the operating system environment

1. Create the installation directory for Agent Controller.

   For example...

   mkdir /u/rpt/IBM/RAC

2. Set ASSIZEMAX=2147483647.

   This might require support from the system programmer.

3. Add the following export commands to the .profile of the user ID that will be used to start Agent Controller:

   export RASERVER_HOME={install location}
   export LIBPATH=$LIBPATH:/path/to/RPT/lib:/path/to/java/bin:/path/to/java/bin/classic
   export PATH=$PATH:/path/to/RPT/bin:/path/to/java/bin
   export _BPX_SHAREAS="NO"
   

4. Use the java -fullversion command to verify the Java version. Java version 1.6 or later is required.

Install Agent Controller

The Rational Performance Tester agent includes Agent Controller and the data collection infrastructure.

1. In a UNIX System Services shell, go to the directory where you will install Agent Controller.
   cd /usr/lpp/

2. Transfer the following installation images to /usr/lpp...
   ibmrac.os390.pax
   tptpdc.os390.pax

3. Extract Agent Controller files:
   pax -ppx -rvf ibmrac.os390.pax

4. Extract test and performance tools (TPTP) Agent Controller files:
   pax -ppx -rvf tptpdc.os390.pax

5. Make the Agent Controller shared object files program controlled...
   extattr +p /usr/lpp/IBM/AgentController/lib/*.so

6. Extract Agent Controller files:
   pax -ppx -rf tptpdc.nl1.os390.pax
   pax -ppx -rf tptpdc.nl2.os390.pax

7. Run the setup script...
   cd /usr/lpp/IBM/AgentController/bin
   ./SetConfig.sh

8. Follow the on-screen prompt to configure Agent Controller.

Start and stop Agent Controller on the z/OS (OS/390)

1. Log in as user root and start the server...
   cd /usr/lpp/IBM/AgentController/bin
   ./RAStart.sh

2. To stop the server, log in as root and run...
   cd /usr/lpp/IBM/AgentController/bin
   ./RAStop.sh

Uninstall the Agent Controller for Rational Performance Tester on the z/OS (OS/390)

1. If you ran the createLinks.sh command when installing Agent Controller, then run...
   /usr/lpp/IBM/AgentController/bin directory, and issue this command:
   ./removeLinks.sh

2. Remove the IBMRAC directory and all of its subdirectories...
   rm -rf /usr/lpp/IBM/AgentController