Installing IBM Agent Controller on Windows

  1. Log on as an administrator.
  2. Start of changeIf you already have Agent Controller installed, check what version it is:
    1. Find RAServer.exe in the bin directory of the Agent Controller installation.
    2. Right-click and select Properties.
    3. Select the Version tab.
    4. The version is listed as "File version". For example, if you already have the required version, this is displayed as 5.0.2.0. (For most versions, the "Product Version" under "Other information" has the same value.)

    If you need to install a later version, uninstall the current version of Agent Controller using the instructions in Uninstalling IBM Agent Controller on Windows.

    End of change
  3. Close the Services window if it is open (Start > Settings > Control Panel > Administrative Tools > Services). If it is open, Agent Controller cannot be installed.
  4. Run setup.exe from the directory in which you stored the downloaded files.
  5. From the WebSphere Studio Installation Launcher window, select Install IBM Agent Controller.
  6. Follow the on-screen instructions. You need to consider the following when you install Agent Controller:
    • By default, Agent Controller is installed in the system_drive\Program Files\IBM\IBM Agent Controller\ directory (where system_drive is the hard drive where Windows is installed). The Agent Controller service starts automatically when it is installed and then whenever you start your system.
    • On the Java Runtime Environment page of the wizard, you must specify the location of the Java runtime file (java.exe).
    • Start of changeOn the Security page of the wizard, specify whether Agent Controller will require encrypted and authenticated communications. If security is disabled, only the host list is used to control access to Agent Controller. If security is enabled, clients are only able to connect to Agent Controller if they contain the necessary certificates to authenticate Agent Controller for Secure Socket Communications. Also, all clients are required to login to Agent Controller for debugging broker flows.End of change
    • On the Host List page of the wizard, you specify that computers can access the Agent Controller you are currently installing. Usually these are the computers where WebSphere Studio Application Developer Integration Edition is installed.
      • The This computer only radio button does not allow any computer other than this one to access Agent Controller.
      • The Specific computers radio button allows you to specify the host name or the network name of one or more computers that can access Agent Controller. The host names are specified as a space delimited list.
      • The Any computer radio button allows all computers to access Agent Controller.

Stopping and starting the Agent Controller service

When you have successfully installed Agent Controller, the Agent Controller service is started automatically on Windows. You can stop and start the service using the Services window. You are strongly recommended to change the Startup type from Automatic to Manual. If you do not use the flow debugger, stop the Agent Controller service.