- 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.
- Issue the following command to extract Agent Controller
files (which you downloaded from the WebSphere
Business Integration Brokers Support Web page):
pax -ppx -rzf <IBMRAC_LOCATION>/ibmrac.os390.pax.Z
The
files will be 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
- 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
To enable the z/OS broker to connect to the Agent Controller,
ensure the lib directory of the installed Agent Controller
(for example /usr/lpp/IBMRAC/lib) is part of the LIBPATH in the ENVFILE of the
broker. You can add this by stopping the broker, changing the LIBPATH environment
variable in the mqsicompcif file, recustomizing, and
then restarting the broker.