Install the product software

Use these instructions to install HCL OneTest™ Performance.

Before you begin

  • Download and install IBM® Installation Manager from
  • To install the product on a Linux computer, install IBM Java 8 from For, 64 bit product, download 64 bit Java from “Linux on AMD64/EMT64T” section and for 32 bit product, download it from “Linux on Intel” section.
  • To install the product on a Windows computer, install Oracle JDK 8.
  • If you were using the IBM testing product and want to reuse the test assets in the HCL testing product, follow these instructions:
    • From the IBM testing product, export all the test assets with dependencies. Follow instructions till step 5 in Copying test assets with dependencies.
    • Uninstall the IBM testing product.
    • Install the HCL testing product by following the instructions in this topic.
    • Import the test assets with dependencies to the HCL workspace. Follow instructions from step 6 in Copying test assets with dependencies.

About this task

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

You cannot upgrade from version 9.2.1 to Uninstall the existing version of the product before installing

Currently, collection of response time breakdown data from macOS system is not supported.


  1. Review the Installation considerations, if you have not done so already.
  2. In the Installation Manager, click File > Preferences > Repositories, and add a repository link to the product's setup disk and click OK.
  3. Click Install.
  4. Click a product package to highlight it. The description of the package is displayed in the Details pane at the bottom of the screen.
  5. 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 below 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.
  6. 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.
  7. 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.
  8. 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\HCL\HCLIMShared
    • For Linux. /opt/HCL/HCLIMShared
    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.
  9. 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\HCL\HCLProducts
      • For Linux. /opt/HCL/HCLProducts
    3. Click Next to continue.
  10. 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: HCL OneTest Performance does not support extending an existing Eclipse IDE.
  11. 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.
  12. 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. When you are finished selecting features, click Next to continue.
  13. On the Select Java Runtime page, for Enter Java Executable, specify the path to IBM JDK or Oracle JDK or use Select Java Executable from list to select the Java path.
    Note: After installing the product, you cannot update the Java path. To change the Java path, you must uninstall and then install the product. If you choose to specify Java directory path as C:\ProgramData\Oracle\Java\javapath, you can install IBM JDK or Oracle JDK on any directory.
  14. 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.
  15. 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.
  16. License the product.

    See the Applying the license topic.