- 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.
Customize 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.
- 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