Installing IBM Agent Controller

IBM Agent Controller 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 Business Integration Message Broker uses Agent Controller to provide debugging facilities for message flows deployed to a running broker. Other IBM products might also use Agent Controller for services.

If you are debugging an execution group locally, you must install Agent Controller on the local system before you can use the flow debugger. If you are debugging an execution group remotely, you must install Agent Controller on the remote system on which your broker is running.Start of change Also, the Agent Controller component installed on the broker must have TCP/IP connectivity to the system the Message Brokers Toolkit is running on to allow it to communicate with the Agent Controller client which is embedded in the Message Brokers Toolkit.End of change

  1. Check the version of the broker that you want to debug.

    The table below shows what is supported on the different platforms for use with Version 5 brokers:

      Version 5 Fix Pack 3 Broker and beyond with RAC 5.0.21 Version 5 Fix Pack 2 Broker and below with RAC 5.0.2 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
    Notes:

    1. A specific Agent Controller build is required for Fix Pack 3 and later brokers; only Version 5.0.2 Build 20040205_1459 works correctly. This build applies to all broker operating systems. If you have a different version of Agent Controller installed (even if it is a later version), you must uninstall it and install this build.

  2. Download the appropriate version of Agent Controller from the WebSphere Business Integration Message Broker support Web page .
  3. Refer to the instructions about installing Agent Controller on your platform. You are highly recommended to install Agent Controller behind a firewall and to stop the Agent Controller service if you do not use the flow debugger.
  4. In the workbench, select the option in the Flow Debug preference page that corresponds to your broker configuration; the default selection is Message Broker CSD3 and beyond (CSD3 refers to Fix Pack 3), as documented in Setting flow debug preferences.
Related tasks
Installing
Checking software prerequisites
Uninstalling IBM Agent Controller