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. Start of changeIf 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.

    End of change
  3. Start of changeIssue 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. End of change
  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. Start of changeTo 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.End of change
  9. Start the server by logging on as root, opening the /usr/lpp/IBMRAC/bin directory and issuing the command:
    /RAStart.sh
  10. 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