- 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.
If you already have Agent Controller installed, check
what version it is: - Find the RAServer executable file in the <install_dir>/bin directory.
- Obtain the timestamp of the RAServer executable file.
- 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.

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. 
- 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
- Reply to the following prompts:
- IBM Agent Controller installed location:
enter the location of Agent Controller, for example, /usr/lpp/IBMRAC.
- 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.
- WebSphere Application Server V5 installed location:
leave this blank.
- Security (yes/no): enter no because
the security feature is not supported.
- 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.
- 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.
- To profile programs running on WebSphere Application Server, go
to the usr/lpp/IBMRAC/bin directory and issue the command:
./makelinks.sh
- 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
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.
- Start the server by logging on as root, opening the /usr/lpp/IBMRAC/bin directory
and issuing the command:
/RAStart.sh
- To stop the server, log in as root, open the /usr/lpp/IBMRAC/bin directory,
and issue the command:
./RAStop.sh