Installing Agent in the console mode on Linux

To install the HCL OneTest Performance Agent on Ubuntu and Red Hat Enterprise Linux (RHEL) operating systems where GUI mode is not supported, you can use the console-mode installation method.

Before you begin

You must have completed the following tasks:

  • Uninstalled the previous version of the product. See Uninstalling in the console mode on Linux.

  • Installed Konsole on your computer. The Konsole application is required to enable the shortcut icon of the product after installation. You can install Konsole by running the apt-get install konsole command in the terminal.
    Note: You need not install Konsole on the computer that is running RHEL 8 or later.
  • Verified that the following libraries are available on your computer, if you want to install HCL OneTest UI:
    • libnsl.so.1
    • libstdc++.so.6
    • libXp.so.6
    • libgtk-x11-2.0.so.0
    • libXtst.so.6
    • libXt.so.6
    • libstdc++.so.5
    • libXft.so.2
    • libXm.so.4
    Note: For more information on the library dependencies on Linux, refer to Library dependency on Linux.
  • Verified the software and hardware requirements. See System Requirements.

About this task

In console mode, the installation process is an interactive and text-based. You can install the product in the console mode only on the Ubuntu and RHEL operating systems.

You can use the stand-alone installer and the product in your preferred language. The display language of your computer is selected as the preferred language of the stand-alone installer. For example, if the display language of your computer is set as French, then the preferred language of the stand-alone installer is also selected as French.

You can change the language of the stand-alone installer and the product by providing the appropriate number during the installation of the product.

The following languages are displayed in the drop-down list based on the display language of your computer:
List of preferred languages that are displayed in the drop-down list based on the display language of your computer
  • English
  • French
  • German
  • Italian
  • Spanish
  • Portuguese Brazil
  • Simplified Chinese
  • English
  • Traditional Chinese
  • English
  • Japanese
  • English
  • Czech
  • English
  • Hungarian
  • Polish
  • Korean
  • English
  • Turkish
  • English
  • Russian
  • English
For example, if the display language of your computer is Japanese, then the drop-down list shows Japanese and English as the preferred languages.

If you do not want to configure the agent during the installation of the product, then you can leave the configuration fields blank. Later, when you decide to configure the agent, you can update the parameter values in the Majordomo.config file. The Majordomo.config file is at the following location:

/HCL/HCLoneTest/Majordomo.config

Note: The URL Alias parameter name is shown as a slug in the Majordomo.config file.

Procedure

  1. Download the product installer from the HCL® License & Delivery portal.

    You must download the appropriate product variant, version, and architecture based on your requirements.

  2. Open the terminal and log in as a root user.
  3. Run the following command to change the directory from root to the directory where you downloaded the installer zip file:
    cd <path of the downloaded folder>

    For example, cd Downloads/

  4. Run the following command to extract the product installer zip file:
    unzip <product package name>

    For example, unzip HCL-OneTest-Performance-Agent-Windows-x64-v10.2.0.0.zip

    The command-line interface displays the list of preferred languages based on the display language that is set on your computer.

    Note: To identify the display language of your computer, the command-line interface displays an arrow mark (->) that precedes the name of the language.
  5. Enter a number to select your preferred language, and then Enter.
    The installation instructions are displayed in your preferred language.
  6. Run the following command to begin the installation process:
    ./<filename.bin> -i console

    For example, ./HCL-OneTest-Performance-Agent-Windows-x64-v10.2.0.0.bin -i console

  7. Review the license agreement and perform the following actions:
    • Read the license agreement by pressing any key along with the Enter key to continue reading the license agreement.

    • At any time, press 0 (zero) along with the Enter key to go to the end of the license agreement.

    • After you read the license agreement, enter Y to accept the license agreement and continue with the installation.

    Note: You can type N if you want to cancel the installation.
  8. Provide the path where you want to install the product and perform the following steps:
    1. Press Enter to install the product in the default path: /opt/HCL.
    2. Enter the complete path of the directory and press Enter to install the product in the new directory path.
    Note: You can type Back and press Enter to go to the previous step if you want to modify your inputs during the installation process.
  9. Optional: Perform the following steps to configure the agent:
    1. Specify the values for the following parameters for HCL OneTest UI:
      Field name Description Example
      Host name The hostname of HCL OneTest UI. localhost
      Port The port number of HCL OneTest UI. 7080
    2. Specify the values for the following parameters for HCL OneTest Server:
      Field name Description Example
      Host name The hostname of HCL OneTest Server.
      Note:
      • The hostname of HCL OneTest Server must be resolvable through a Domain Name Server (DNS).

      • An IP address cannot be the hostname of HCL OneTest Server.

      • The hostname of HCL OneTest Server through host files must not be specified.

        For example, /etc/hosts or C:/Windows/system32/drives/etc/host

      localhost
      Port The port number of HCL OneTest Server. 443
      Token An offline user token that is created from HCL OneTest Server. eyJhbGciOiJIUzI1NiIsInR
      URL Alias The name of the URL Alias that you provided during the creation of the team space in HCL OneTest Server. testteam
  10. Review the pre-installation summary, and then press Enter to continue with the installation process.
  11. Press Enter to exit the installer.
    Note: If the installation of the product is not successful, you can check the errors that occurred during the installation in the log file. The log file is available at the location: /opt/HCL/Logs.

Results

You have installed the agent on your computer.
Note: If the installation of the product is not successful, you can check the errors that occurred during the installation in the log file. The log file is available at the location: /opt/HCL/Logs.

What to do next

You must enter the license key when you open the product. See License management.