Installing Agent Controller

Agent Controller must be installed and running on the same system as the WebSphere® Portal server where the portlet that you want to profile is running.

These instructions provide simplified steps for installing Agent Controller. For detailed instructions, including software and hardware prerequisites, troubleshooting, and instructions for installing on different types of systems, see the Installing Agent Controller in the Installation Guide, which is available from the Rational® installation launchpad.

To install Agent Controller:

  1. Start the Rational installation launchpad.
  2. Select Install Agent Controller. The installation program starts.
  3. On the Welcome panel, click Next.
  4. Stop Rational Developer if it is running. Click Next.
  5. Read and accept the Software License Agreement. Click Next.
  6. Select an installation directory for Agent Controller. Click Next.
  7. Select all of the Agent Controller features for installation. Click Next.
  8. Provide the location of the Java™ executable program, java.exe. The Java version must be 1.4 or higher.
    • To use the Java provided with Rational Developer, the location is:
      Rational_Developer_installation_root/eclipse/jre/bin/java.exe
    • To use a locally installed copy of Java, the location is:
      Java_installation_root/jre/bin/java.exe
  9. Click Next. Specify the location of WebSphere Application Server v5.1 or v5.0.
    To use a local WebSphere test environment, the location would be one of the following:
    Rational_Developer_installation_root/runtimes/base_v5
    Rational_Developer_installation_root/runtimes/base_v5_stub
    Rational_Developer_installation_root/runtimes/base_v51
    Rational_Developer_installation_root/runtimes/base_v51_stub
  10. Click Next. On the Host List panel, select one of the following options to define the computers that can connect to the Agent Controller you are installing:
    • Any computer, the default value.
    • This computer only to limit access to the local system.
    • Specific computers to list specific host names, separated by commas.

    Click Next.

  11. On the Security panel, select Disable or Enable to disable or enable encrypted communication. Click Next > Next. The installation of Agent Controller begins.
  12. Click Finish after the installation completes.
  13. If the Rational Developer installation launchpad is still open, click Exit to close it.
Note: To profile applications using Agent Controller on remote servers, profiling must be enabled on the remote WebSphere Portal server.
Related tasks
Profiling portlets on local servers
Profiling portlets on remote servers
Enabling profiling on remote WebSphere Portal servers
Defining profiling options
Profiling an application

(C) Copyright IBM Corporation 2002, 2005. All Rights Reserved.