How to install IBM Rational Agent Controller for z/OS

Technote (FAQ)


Question

How do you install IBM Rational Agent Controller for z/OS as part of IBM Rational Performance Tester (RPT)?

Cause

The available instructions pertain to an older IBM Rational Performance Tester version. You cannot install IBM Rational Agent Controller on z/OS.

Answer

Below you can find the installation instructions of IBM Rational Agent Controller for z/OS.These instructions work for either IBM Rational Performance Tester 8.3.0.x or IBM Rational Performance Tester 8.5.

Please note that the instructions currently provided in the Help are not applicable to IBM Rational Performance Tester 8.3/8.5. My instructions are organized similar to the ones in the Help.


  1. Download the Rational Agent Controller (RAC), rac.zos_V8.3.5.zip Version 8.3.5, for z/OS.

  2. Extract rac.zos.31bit.zip from the downloaded rac.zos_V8.3.5.zip.

  3. Extract rac.jre.31bit.pax and rac.zos.31bit.pax from rac.zos.31bit.zip. The license agreement for the RAC is also included in rac.zos.31bit.zip.

  4. Log into the z/OS computer.

  5. Create a new directory (the "installation directory") for holding the RAC, for example /usr/lpp/RAC_8.3.5. You will need at least 300 MB of free disk space on the file system holding this directory.

  6. Add the following commands (replacing /usr/lpp/RAC_8.3.5 with the actual installation directory) to the .profile of the user ID that will be used to start Agent Controller.


      export RASERVER_HOME=/usr/lpp/RAC_8.3.5
     export LIBPATH=$LIBPATH:/usr/lpp/RAC_8.3.5/lib:/usr/lpp/RAC_8.3.5/jre/
            J7.0/bin:/usr/lpp/RAC_8.3.5/jre/J7.0/bin/classic
     export PATH=$PATH:/usr/lpp/RAC_8.3.5/bin:/usr/lpp/RAC_8.3.5/jre/J7.0/
            bin
     export _BPX_SHAREAS="NO"



  7. Move rac.jre.31bit.pax and rac.zos.31bit.pax to a temporary location on the z/OS computer, for example /tmp/rac.jre.31bit.pax and /tmp/rac.zos.31bit.pax.

  8. Go to the installation directory (/usr/lpp/RAC_8.3.5) and issue the command:

         pax -ppx -rvf /tmp/rac.zos.31bit.pax

  9. Create a new subdirectory, jre, in the installation directory.

  10. Change to the new jre directory (/usr/lpp/RAC_8.3.5/jre) and issue the following command.

         pax -ppx -rvf /tmp/rac.jre.31bit.pax

  11. Change to the installation directory (/usr/lpp/RAC_8.3.5) and issue the following command.

         extattr +p lib/*.so

  12. Change to the installation directory's bin subdirectory (/usr/lpp/RAC_8.3.5/bin) and issue the command.

         ./SetConfig.sh

  13. When prompted for the fully qualified path of java, specify the following or the equivalent, if you did not install in /usr/lpp/RAC_8.3.5.

    /usr/lpp/RAC_8.3.5/jre/J7.0/bin/java

  14. Specify ALL when prompted for Network access mode.

  15. Use the default setting (FALSE) for Security enabled.

  16. Delete the /tmp/rac.jre.31bit.pax and /tmp/rac.zos.31bit.pax files from Step 7 above.


The installation of the Rational Agent Controller is complete.



NOTES

  • Before running large workloads on the z/OS agent, the recommendation is to you adjust per-user maximum address space size by setting ASSIZEMAX=2147483647. Ask your system administrator how to set ASSIZEMAX.

    -------------------------------------------------------------------------

  • To start the Rational Agent Controller, log into the z/OS system and go to the installation directory's bin subdirectory and run the RAStart.sh script.

       cd /usr/lpp/RAC_8.3.5/bin
      ./RAStart.sh


    Observe the following messages:

       Starting Agent Controller.
      ACServer started successfully

    -------------------------------------------------------------------------


  • To stop the Rational Agent Controller, log into the z/OS system and go to the installation directory's bin subdirectory and run the RAStop.sh script.

       cd /usr/lpp/RAC_8.3.5/bin
      ./RAStop.sh


    Observe the following messages.

      Shutting down the Agent Controller ...
      ACServer stopped.

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Performance Tester
Agent Controller

Software version:

8.3, 8.3.0.1, 8.3.0.2, 8.3.0.3, 8.5

Operating system(s):

Windows

Reference #:

1642968

Modified date:

2013-07-09

Translate my page

Machine Translation

Content navigation