Installing Rational Performance Tester Agent

Use these instructions to install Rational® Performance Tester Agent.

Before you begin

Before you start the installation, review the installation considerations.

About this task

By starting the installation process from the launchpad program, IBM® Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the location of the repository that contains the product package. If you install and start directly, you must set repository preferences manually.

To learn how to install the product from a command prompt in silent mode, see the Installing Silently section of the IBM Installation Manager Information Center.

Procedure

  1. Complete one of the following steps:
    1. If you are installing from compressed files, such as .zip or ISO files, extract the files into a common directory. Navigate to Common_Directory/RPTAGENT_SETUP/disk1/Platform_Directory and double-click install.exe.
    2. If you are installing from a CD, insert the first product CD into your CD drive. If autorun is enabled on your workstation, the launchpad starts automatically. Otherwise, start the launchpad program manually.
      • For Windows. Run the launchpad.exe command, which is located in the root directory of the Setup disk installation image.
      • For Linux. Run the launchpad.sh command, which is located in the root directory of the Setup disk installation image.
  2. Optional: Select a language in which to run the launchpad and IBM Installation Manager.
  3. Click a product package to see its description in the Details pane at the bottom of the screen.
  4. To search for updates to the product packages, click Check for Other Versions, Fixes, and Extensions. If updates for a product package are found, they are displayed in the Installation Packages list on the Install Packages page below their corresponding product. Only recommended updates are displayed by default.
    • To view all updates that are found for the available packages, click Show all versions.
    • To display a package description under Details, click the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package that you are installing, review all the information.
      Note: For IBM Installation Manager to search the predefined IBM update repository locations for the installed packages, the Search the linked repositories during installation and updates preference on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required. A progress indicator shows that the search is taking place. You can install updates at the same time that you install the base product package.
  5. Select the product package and updates to the package to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
    Note: If you install multiple packages at the same time, all the packages are installed into the same package group.
  6. On the Licenses page, read the license agreement for the selected package. If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.
    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  7. On the Location page, in the Shared Resources Directory field, type the path for the shared resources directory or accept the default path. The shared resources directory contains resources that one or more package groups can share. Click Next to continue.
    These default paths are provided:
    • For Windows. C:\Program Files\IBM\IBMIMShared
    • For Linux. /opt/IBM/IBMIMShared
    Important: You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this directory to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
  8. On the Location page, create a package group to install the product package into or for an update, use the existing package group. A package group represents a directory in which packages share resources with other packages in the same group. To create a package group, complete these steps:
    1. Click Create a new package group.
    2. Type the path for the installation directory for the package group. The name for the package group is created automatically.
      These default paths are provided:
      • For Windows. C:\Program Files\IBM\SDP
      • For Linux. /opt/IBM/SDP
    3. Click Next to continue.
  9. On the next Location page, you can choose to extend an existing Eclipse IDE that is installed on your computer, adding the functions in the packages that you are installing. Click Next.
    Note: Rational Performance Tester Agent does not support extending an existing Eclipse IDE, so you can ignore this page.
  10. On the Features page under Translations, select the languages for the package group. The corresponding translations for the user interface and documentation for the product package will be installed.
  11. On the next Features page, select the package features to install.
    1. By default, the Load Generation Agent check box is selected. The Load Generation Agent is used to generate a load on the system under test. The Rational Agent Controller gathers data for the Response Time Breakdown feature and supports the startup and control of web services stubs in the SOA protocol.
      Note: IBM Installation Manager automatically enforces any dependencies with other features and displays updated download sizes and disk space requirements for the installation.
    2. Optional: To see the dependency relationships between features, select Show Dependencies.
    3. Optional: Click a feature to view its brief description under Details.
    4. After you are finished selecting features, click Next to continue.
  12. On the next Features page, configure the agent:
    1. For Load Generation Agent, type the workbench host name. If you do not want to use 7080 as the port number, change the port number. You can also change the port number after you install Rational Performance Tester Agent. For more information, see the Configuring ports for agents topic.
    2. For Rational Agent Controller, select either a Typical installation or a Custom installation. If you select Custom installation, you can define an access list and enable security:
      • Access List: You can limit access to the computer where the agent controller is installed or to a list of specific computers.
      • Security: You can enable encrypted communication and limit access to a specified set of user IDs.
    3. Click Next.
  13. On the Summary page, review your choices before installing the product package. To change the choices that you made on previous pages, click Back, and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation that is complete.
  14. When the installation process is complete, a message confirms the completion of the process.
    1. Click the View log file button to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. Click Finish to start the selected package. The Install Package wizard closes and you return to the launchpad program.
  15. To collect data on a system under test, you must complete these steps to enable the test server for data collection:
    1. To open the instrumentation application, click Start > IBM Data Collection Infrastructure > Application Server Instrumenter.
    2. Click Instrument Local Server, and select the type of application server that is running on the server.
    3. Specify the server type fields, including the location of the server if required, and click OK.
    4. Stop and start the server for the instrumentation to take effect.
    Note: All IBM Rational Performance Tester systems that are involved with the data collection infrastructure must have the data collection software running for the transaction breakdown function to be available within the results of a Rational Performance Tester test schedule.
    Note: The application server instrumenter or the instrumentServer.bat (or instrumentServer.sh) batch file can fail with a generic error message (Error during install/uninstall) when instrumenting or uninstrumenting a server. If this error occurs, you can find more information to help troubleshoot the error in the log files in the IBM Tivoli® common directory. On Windows, the default location of this directory is C:\Program Files\IBM\tivoli\common. On Linux, the default location of this directory is /var/ibm/tivoli/common. If the IBM Tivoli common directory is not in the default location, search for a path that contains tivoli/common, or for any of these log files: trace-install.log, trace-ma.log, or trace-tapmagent.log.
    Note: For IBM WebSphere® Application Server 6.0 or later, if you create a new profile and then use the application server instrumenter to instrument this profile without first starting WebSphere Application Server, the application server instrumenter reports that the server is instrumented and prompts you to restart the server manually. This message is incorrect; the server is not actually instrumented. To work around this problem, complete these steps:
    1. Close and then restart the application server instrumenter.
    2. Select the entry that you just added from the list of instrumented servers, and click Remove.
    3. Restart WebSphere Application Server.
    4. Restart the application server instrumenter, and use it to instrument the server.
    To avoid this problem, after you create a new profile, start the WebSphere Application Server profile manually. Then, use the application server instrumenter to instrument the server.

Feedback