Installing HCL OneTest UI

This topic provides the instructions for installing HCL OneTest™ UI.

Before you begin

  • Verify that your computer meets the system requirements, and complete the preinstallation tasks.
  • To install the product on a Ubuntu 16 computer, you must have installed libxm4 and libxp6 packages.
    • Add deb precise-security main to /etc/apt/sources.list
    • From the terminal, pass these commands:

      $ sudo apt-get update and $ sudo apt-get install libxm4 libxp6
  • HCL Products and Platforms manages software licensing and downloads through the License and Delivery Portal. You must have ordered software and followed the instructions that you received to activate your entitlement and download the software from the Portal. These instructions help you complete the following steps:
    • Order the software. Gather the URL and login credentials for the HCL License & Delivery Portal.
    • Log in to the Portal.
    • Create a User associated with your account.
    • Create a Device to host the license server and record the server ID that is returned when the device is created.
      Important: The server ID uniquely identifies your company’s entitlement and must be kept secure.
    • Map your entitlement to the license server Device.
    • Download the software.
  • Download and install IBM® Installation Manager.
  • 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:
Note: Install the product either using root user or using Sudo access.


To install HCL OneTest UI on the Windows or Linux operating systems:

  1. Start Installation Manager and from File > Preferences > Repositories, add a new repository link by pointing to the setup disk of the product.
  2. On the IBM Installation Manager Start page, click Install.
  3. The Install Packages page lists all the packages found in the repositories that Installation Manager searched. If two versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
    • To display all versions of the packages that Installation Manager finds, click Show all versions.
    Note: To search the predefined IBM update repository locations for the installed packages, make sure that Search service repositories during installation and updates is selected on the Repositories preference page. This preference is selected by default.
  4. If updates for the HCL OneTest UI package are found, then they will be displayed in the Installation Packages list on the Install Packages page below their corresponding product. The latest updates are displayed by default.
    • To find other versions, fixes and extensions for the available packages in the update repository locations, click Check for Other Versions, Fixes and Extensions.
    • To view all updates 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 you are installing, review all information beforehand.
  5. Select HCL OneTest UI, the required version, and Installation Manager, if necessary. Click Next. Updates that have dependencies are automatically selected and cleared together.
    Note: If you install multiple packages at the same time, then all the packages will be 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, 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.
    Important: If you are installing on Windows, then to enable users who do not have Administrator privileges to work with HCL OneTest UI, do not choose a directory inside the Program Files directory (C:\Program Files\).
    The default path is:
    • 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.
  8. On the Location page, specify whether to create a package group and install the HCL OneTest UI package into a new package group or use an existing package group to shell-share with another offering. A package group represents a directory in which packages share resources with other packages in the same group. To create a new 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 is:
      • For Windows:C:\Program Files\HCL\HCLOneTest
      • For Linux:/opt/HCL/HCLOneTest
      Note: If you are installing on Linux, ensure that you do not include any spaces in the directory path.
      Important: On Windows Vista, the Program Files directory is usually virtualized in order to allow users who are not running as the administrator to have write access to this protected directory. However, the virtualization workaround is not compatible with HCL OneTest UI.
    3. Click Next to continue.
  9. On the next Location page, you can choose to extend an existing Eclipse IDE already installed on your system, adding the functionality in the packages that you are installing. You must have Eclipse version 3.6.2 with the latest updates from to select this option.
    • If you do not want to extend an existing Eclipse IDE, click Next to continue.
    • To extend an existing Eclipse IDE:
      1. Select Extend an existing Eclipse.
      2. In the Eclipse IDE field, type or navigate to the location of the folder containing the eclipse executable file (eclipse.exe or eclipse.bin). Installation Manager will check if the Eclipse IDE version is valid for the package that you are installing. The Eclipse IDE JVM field displays the Java Virtual Machine (JVM) for the IDE that you specified.
      3. Click Next to continue.
  10. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the HCL OneTest UI package will be installed.
  11. On the next Features page, select the package features that you want 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 will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
    4. Click Next to continue.
      Uninstalling Microsoft Visual Studio: If you must uninstall Microsoft Visual Studio when the Microsoft Visual Studio .NET Integration feature of HCL OneTest UI is installed, you must uninstall the Microsoft Visual Studio .NET Integration feature of HCL OneTest UI and then uninstall Microsoft Visual Studio. Use the Modify option in the Installation Manager to uninstall the Microsoft Visual Studio .NET Integration feature. For information about the Modify option, see Modifying installations.
  12. 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.
  13. On the Summary page, review your choices before installing the HCL OneTest UI package. If you want 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 completed.
  14. When the installation process is complete, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window.
    2. The features that you installed are listed in the Which program do you want to start section. Select the feature that you want to start: HCL OneTest UI Eclipse Integration or HCL OneTest UI Microsoft Visual Studio Integration. To exit Installation Manager without starting any of the installed features, select None.
    3. Click Finish.

What to do next

Start the product as a root user or Sudo access for the first time. When you start the product, apply the product license key.

To create a project, you must enable Java in the product. See Enabling Java environments.