Rational® Agent Controller (RAC) is a daemon process that provides the mechanism by which client applications either launch new host processes or attach to agents that coexist within existing host processes. WebSphere® Message Broker uses RAC to provide debugging facilities for message flows that are deployed to a running broker.
Before you can use the flow debugger, you must install RAC on all computers on which you run the brokers in which you want to debug message flows. Also, check that the RAC component installed on the broker has TCP/IP connectivity to the system on which the Message Brokers Toolkit is running, to enable it to communicate with the RAC client which is embedded in the Message Brokers Toolkit.
Rational Agent Controller Versions 6.0.1 and 5.0.2.1 are supported for use with WebSphere Message Broker Version 6.0.
If you are not sure which version of RAC you have installed, see the instructions on how to check the RAC version on your broker operating systems.
Version 5 Fix Pack 3 Broker and beyond with RAC 5.0.2.1 | Version 5 Fix Pack 2 Broker and below with RAC 5.0.2.1 | Version 5 Fix Pack 2 Broker and below with RAC 5.0.1 | |
---|---|---|---|
Windows® | Yes | Yes | Yes |
AIX® | Yes | Yes | Yes |
Solaris | Yes | Yes | No |
HP-UX | Yes | No | No |
z/OS® | Yes | No | No |
Linux® | Yes | No | No |
To use RAC with WebSphere Message Broker brokers, complete the following steps:
./setup.bin -is:log /tmp/rac.log -log !/tmp/rac_events.log @ALL
On some Linux and UNIX shells, you might have to escape the exclamation mark (!) with the backslash character (\). If you do not escape the exclamation mark when required, a message similar to the following error is displayed:
-bash: !/tmp/rac_events.log: event not found
setup.exe -is:log \tmp\rac.log -log !\tmp\rac_events.log @ALL