Installing IBM Agent Controller on Solaris, HP-UX, and AIX

Ensure that you have installed the Java Development Kit V1.3.0 or higher.

  1. Log on as root.
  2. Start of changeIf you already have Agent Controller installed, check what version it is on your system:
    • On Solaris:
      1. pkginfo -x > pkginfo.txt
      2. vi pkginfo.txt
      3. Search for "ibmrac" (if RAC is at 5.1 or later) or "28887f2df81d126aa228a4f84b6051d5" (if RAC is at 5.0.x).
      4. Find the version displayed on the line following the search string, reverse the third and fourth digits, and ignore trailing characters. For example if the version is displayed as "5.1.0.2DSP", this represents "5.1.2".
    • On HP-UX: enter
      swlist | grep IBMRAC
      if RAC is at 6.0 or later or
      swlist | grep 628282f51593896a6d94a9eee71770f5
      if RAC is at 5.0.x.
    • On AIX: enter
      lslpp -i ibmrac
      if RAC is at 5.1 or later or
      lslpp -i e22643e413d203c89236cd92ef065fbc
      if RAC is at 5.0.x.

    If you need to install a later version, uninstall the current version of Agent Controller using the instructions in Uninstalling IBM Agent Controller on Solaris, HP-UX, and AIX.

    End of change
  3. Start of changeRun setup.jar from the directory in which you stored the downloaded files.
    java -Djava.compiler=NONE -jar setup.jar
    End of change
  4. Follow the on-screen instructions. You need to consider the following points when installing Agent Controller:
    • By default, Agent Controller is installed in /usr/IBMRAC on AIX and /opt/IBMRAC on HP-UX and Solaris.
    • Specify where the Java Runtime file (java) is located: type the location where the java file can be found (for example /usr/java/jre/bin).
    • WebSphere Application Server V5 installed location: you can leave this field blank if it is not installed.
    • 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. If the Enabled button is selected, you will be asked to enter the users that are allowed access to Agent Controller. You must separate multiple user names by spaces. End of change
    • On the Host List page of the wizard, you specify computers can access the Agent Controller you are currently installing. Usually these are the computers where WebSphere Studio Application Developer Integration Edition are installed:
      • This computer only radio button does not allow any computer other than this one to access Agent Controller.
      • 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.
      • Any computer radio button allows all computers to access Agent Controller.
  5. For AIX, start the server by opening the /usr/IBMRAC/bin directory and issuing the command:
    ./RAStart.sh
    For Solaris or HP-UX, start the server by opening the /opt/IBMRAC/bin directory and issuing the command:
    /RAStart.sh
  6. To stop the server, open the /opt/IBMRAC/bin directory on HP-UX or Solaris, or the /usr/IBMRAC/bin directory on AIX, and issue the command:
    ./RAStop.sh
Related tasks
Mounting CDs on Solaris
Mounting CDs on HP-UX
Mounting CDs on AIX
Uninstalling IBM Agent Controller on Solaris, HP-UX, and AIX