Installing and uninstalling Agent Controller on 31-bit z/OS

To install Rational Agent Controller on 31-bit or 64-bit z/OS operating system:

1. In a UNIX System Services shell, change to the directory where you downloaded the installation files for Rational Agent Controller.
2. Extract the contents of the compressed file that you downloaded.
   • For 31-bit, enter the following command: unzip rac.zos.31bit.zip
   • For 31-bit, enter the following command: unzip rac.zos.64bit.zip

   The contents of the compressed file are extracted into a new subdirectory of the current directory named RACzOS31bit or RACzOS64bit.

3. For 31-bit operating systems, change to the RACzOS31bit subdirectory. For 64-bit operating systems, change to the RACzOS64bit subdirectory.
4. Extract the contents of the .pax file:
   • For 31-bit operating systems, extract the contents of the file rac.zos.31bit.pax by entering the following command: pax -r -f rac.zos.31bit.pax -pp
   • For 64-bit operating systems, extract the contents of the file rac.zos.64bit.pax by entering the following command: pax -r -f rac.zos.64bit.pax -pp
5. Change to the jre subdirectory of the RACzOS31bit or RACzOS64bit directory.
6. Extract the contents of the .pax file:
   • For 31-bit operating systems, extract the contents of the file rac.jre.31bit.pax by entering the following command: pax -r -f rac.jre.31bit.pax -pp
   • For 64-bit operating systems, extract the contents of the file rac.jre.64bit.pax by entering the following command: pax -r -f rac.jre.64bit.pax -pp
7. Enter the following commands to set the environment variables for Rational Agent Controller. In the commands that follow, <Rational Agent Controller directory> is the directory that you used to extract the contents of the installation files.
   1. For 31-bit operating systems, enter the following command: export TPTP_AC_HOME=/<Rational Agent Controller directory>/RACzOS31bit. For 64-bit operating systems, enter the following command: export TPTP_AC_HOME=/<Rational Agent Controller directory>/RACzOS64bit
   2. For 31-bit operating systems, enter the following command: export JAVA_PROFILER_HOME=/<Rational Agent Controller directory>/RACzOS31bit/plugins/org.eclipse.tptp.javaprofiler. For 64-bit operating systems, enter the following command: export JAVA_PROFILER_HOME=/<Rational Agent Controller directory>/RACzOS64bit/plugins/org.eclipse.tptp.javaprofiler
   3. export XERCESC_HOME=/usr/lpp/ixm/IBM/xml4c-5_7
   4. export LIBPATH=$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$JAVA_PROFILER_HOME:$LIBPATH
   5. export JAVA_HOME=$TPTP_AC_HOME/jre/J6.0
   6. export PATH=$JAVA_HOME/bin:$PATH
8. Change to the <Rational Agent Controller directory>/RACzOS31bit/bin directory.
9. Run the following command: ./SetConfig.sh. The configuration program for Rational Agent Controller starts. At the prompts, you can either press Enter to accept the default value shown, or you can enter a different value.
   Tip: In most cases, you must change the value of Network access mode to ALL or CUSTOM (along with the list of clients) so that remote client computers can communicate with Rational Agent Controller.
   The prompts are:
   1. Specify the fully qualified path of "java" (e.g. /usr/java1.4/jre/bin/java): This prompt lists the JRE used by Rational Agent Controller. The default value is the JRE supplied with Rational Agent Controller (/<Rational Agent Controller directory>/RACzOS31bit/jre/J6.0/bin/java). If you want to use a different JRE, enter the path to its java file.
   2. Network access mode (ALL=allow any host, LOCAL=allow only this host, CUSTOM=list of hosts): This prompt lists the hosts that are allowed to access Rational Agent Controller. Enter one of the following options:
      • ALL (the default selection) allows any client to access Agent Controller.
      • LOCAL allows only the local host to access Agent Controller.
      • CUSTOM allows only a list of clients that you specify to access Agent Controller. Use a comma-separated list of host names to specify which computers can access Agent Controller.
   3. Security enabled. (true/false):
      • The default value is false. Communication is not be encrypted and access control is limited to the defined host list.
      • If you enter true, then communication is encrypted and all connections are forced to authenticate for Secure Sockets Communications. You can type a comma-separated list of users that can connect to Agent Controller. These users are required to authenticate to use the tool.
10. If you enabled security in the previous step, then enter the following command:
    1. extattr +ap <Rational Agent Controller directory>/lib/*