Installing Rational® Performance Tester

To test the performance of an application, you must install Rational® Performance Tester.

Before you begin

You must read the tech-note if you are using Mozilla Firefox version 43 or later before you can install the product on Linux or Mac platform. For more information about tech-note, refer to The launchpad does not open when opening launchpad from the terminal.

About this task

If you use the Launchpad program to install the product, IBM® Installation Manager gets installed automatically if you do not have it on your computer and starts the product installation by using the preconfigured repository that contains the product package.

If you install Installation Manager and then install the product, you must set the repository preferences manually.

For more information about installing the product from the command prompt in the silent mode, see IBM Installation Manager Knowledge Centre.


  1. Review the Installation considerations, if you have not done so already.
  2. 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/RPT/disk1/Platform_Directory and double click install.exe.
    2. If you are installing from a CD, insert the first product disc into your CD drive. If autorun is enabled on your workstation, then 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 command, which is located in the root directory of the Setup disk installation image.
      • For Macintosh. From the command line terminal, run open from the root directory of the Setup disk installation image.
      Note: Mac OS commands are case-sensitive.
  3. Select a language in which to run the launchpad and Installation Manager.
  4. Select the product to install from the launchpad menu.
    The Install Packages window opens.
  5. Click a product package to highlight it.
    The description of the package is displayed in the Details pane at the end of the screen.
  6. To search for updates to the product packages, click Check for Other Versions, Fixes, and Extensions. If updates for a product package are found, then they are displayed in the Installation Packages list on the Install Packages page under their corresponding products. 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 in the Details pane, 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 information.
  7. Select the product package and any 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, then all the packages are installed into the same package group.
  8. On the Prerequisite page, if a supported version of IBM® Rational® License Key Administrator is not installed, a warning message is displayed. A supported version of Rational® License Key Administrator comes with the product. To administer a license server, you must install a supported version of Rational® License Key Administrator. If you use the launchpad program to install the product, Rational® License Key Administrator is listed on the Install Packages page. If you start Installation Manager, you must add the repository for Rational® License Key Administrator to install it at the same time as the product. Click Next to continue.
  9. On the Licenses page, read the license agreement for the selected package.
    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.
  10. On the Location page, type the path for the shared resources directory in the Shared Resources Directory field, or accept the default path. The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue.
    The default path to use follows:
    • For Windows. C:\Program Files\IBM\IBMIMShared
    • For Linux. /opt/IBM/IBMIMShared
    • For Macintosh. /Applications/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 to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
  11. On the Location page, create a package group to install the product package into or if this is 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:
    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.
      The default path follows:
      • For Windows. C:\Program Files\IBM\SDP
      • For Linux. /opt/IBM/SDP
      • For Macintosh. /Applications/IBM/SDP
    3. Click Next to continue.
  12. Optional: On the next Location page, you can choose to extend an existing Eclipse IDE that is installed on your computer, which adds the functions in the packages that you are installing. You must have Eclipse Version 3.6 with the latest updates from to select this option. Click Next to continue.
    Note: Rational® Performance Tester does not support extending an existing Eclipse IDE.
  13. 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.
  14. On the next Features page, select the package features to install.
    1. Optional: To see the dependency relationships between features, select Show Dependencies.
    2. Optional: Click a feature to view its brief description under Details .
    3. Select or clear features in the packages. Installation Manager automatically enforces any dependencies with other features and displays updated download sizes and disk space requirements for the installation.
    4. To use Processor Value Unit (PVU) licensing capability, click IBM Rational Test Workbench Processor Value Unit (PVU) support check box.
      Rational® Performance Tester supports the Processor Value Unit (PVU) licensing capability available with the following newly introduced offerings: All of these offerings include either Rational® Performance Tester or the Rational® Performance Tester Agent. When you use any of these new offerings, Rational® Performance Tester utilizes PVU licensed agents to generate virtual user load without the need for Virtual Tester Pack licenses. This virtual user load is limited only by the capacity of the PVU licensed agents.
    5. When you integrate Rational® Performance Tester along with Rational® Application Developer or Rational® Software Architect in a shell-shared mode, you must clear Java 8 OpenJDK with Eclipse OpenJ9 check box during the installation. If you not clear this check box, multiple instances of OpenJDK are installed as Rational® Application Developer and Rational® Software Architect already have an existing OpenJDK.
      Note: If you install Rational® Application Developer or Rational® Software Architect in a separate package, you can select the Java 8 OpenJDK with Eclipse OpenJ9 check box.
    6. When you are finished selecting features, click Next to continue.
  15. On the common licensing configuration page, type the TCP/IP port number and host name of the license servers to use to configure licensing on the workbench computer. Separate the port number and host name with the at sign (@). Separate the port-host pairs with semicolons (;). To use the default port, omit the port number. If you do not know the port numbers and names of license servers to use, you can configure the license servers after installation by using Rational® License Key Administrator.
    For example, to configure three license servers that are named license1, license2, and license3 to use port 27000, the default port, and port 1765 respectively, enter this text: 27000@license1;@license2;1765@license3

    Click Next.

  16. 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 completed.
  17. When the installation process is complete, a message confirms the completion of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. In the Install Package wizard, select whether to start the product when you exit.
    3. Click Finish to start installing the selected package.
  18. License the product.

    See the Managing licenses topics.