Installing IBM Agent Controller on z/OS

  1. In a UNIX System Services shell, go to the directory where you want to install IBM Agent Controller. You are recommended to install it in the /usr/lpp/ directory.
  2. If you already have Agent Controller installed, check what version it is:
    1. Find the RAServer executable file in the install_dir/bin directory.
    2. Obtain the timestamp of the RAServer executable file.
    3. The timestamp for the correct build is 20040205.

    If you need to install a later version, uninstall the current version of Agent Controller using the instructions in Uninstalling IBM Agent Controller on z/OS.

  3. Issue the following command to extract Agent Controller files:
    pax -ppx -rzf <IBMRAC_LOCATION>/ibmrac.os390.pax.Z  
    where <IBMRAC_LOCATION> is the location in which you downloaded the required Agent Controller build. The files are extracted into a subdirectory called IBMRAC.
  4. After you have installed Agent Controller, change the directory to the installed location's bin directory /usr/lpp/IBMRAC/bin, and run the setup script by typing:
    ./SetConfig.sh
  5. Reply to the following prompts:
    1. IBM Agent Controller installed location: enter the location of Agent Controller, for example, /usr/lpp/IBMRAC.
    2. Specify where the Java Runtime file (java) is located: enter the location of the java file, for example, /usr/lpp/java/IBM/J1.3/bin.
    3. WebSphere Application Server V5 installed location: leave this blank.
    4. Security (yes/no): enter no because the security feature is not supported.
    5. Allow hosts (ALL/LOCAL/CUSTOM): specify which computers can access Agent Controller. To allow only this computer, type LOCAL. To allow any computer to connect, type ALL. To specify a list of computers, type CUSTOM.
    6. Allowed host names (separated by spaces): if CUSTOM is selected, enter the host names that can access Agent Controller. Host names do not have to be fully qualified. You can also specify IP addresses.
  6. To profile programs running on WebSphere Application Server, go to the usr/lpp/IBMRAC/bin directory and issue the command:
    ./makelinks.sh
  7. Make Agent Controller shared object files program controlled by issuing the following command in a UNIX System Services shell. To issue this command, you must have a minimum of READ access to the BPX.FILEATTR.PROGCTL FACILITY class. For more information, refer to the z/OS UNIX System Services Planning book.
    extattr +p /usr/lpp/IBMRAC/lib/*.so
  8. To enable the z/OS broker to connect to the Agent Controller, add the lib directory (for example, /usr/lpp/IBMRAC/lib) to the start of the LIBPATH in the ENVFILE of the broker. Stop the broker, update the LIBPATH environment variable in the mqsicompcif file, recustomize, and restart the broker.
  9. Start of changeCustomize the frequency with which the RAC agent checks that RAC has been started. The default polling frequency is 1000 milliseconds. If you want to modify this value, add the environment variable RA_IO_IDLE_TIME to the broker's ENVFILE. Enter a value in the range 1 to 2147483647.End of change
  10. Start the server by logging on as root, opening the /usr/lpp/IBMRAC/bin directory and issuing the command:
    /RAStart.sh
  11. To stop the server, log in as root, open the /usr/lpp/IBMRAC/bin directory, and issue the command:
    ./RAStop.sh
Related tasks
Uninstalling IBM Agent Controller on z/OS