Installing Agent in the GUI mode on Windows systems

You can install HCL OneTest Performance Agent on different computers to apply load on the server that hosts the application under test or to run multiple Web UI tests. When you want to run the test scripts on any computer, you must install HCL OneTest Performance Agent.

Before you begin

  • You must be an administrator.
    Note: If you are a non-admin user, you must have the credentials of an administrator to start the installation by using the Run as Administrator option.
  • You must have completed the following tasks:

About this task

All 32-bit test extensions such as SAP, Citrix, and Siebel are supported only for 32-bit HCL OneTest Performance Agent. The product installer does not support the following features:

  • Updates, modifications, or rollback

  • Shell sharing in Eclipse

  • Sharing of common components

  • Integration with Visual Studio for HCL OneTest UI

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 preferred language of the stand-alone installer and the product by selecting the language from the drop-down list during the installation of the product. The drop-down list displays the languages based on the default language that is set on your computer.

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. Right-click the product installer file and select Run as Administrator.

    The GUI window is displayed.

  3. Select the language from the drop-down list to view the installation instructions and the product in your preferred language.

    The drop-down list displays the languages based on the display language that is set on your computer.

  4. Read through the details on the Introduction window, and then click Next.
  5. Read the license agreement carefully, select the I accept checkbox, and then click Next.
  6. Read the Microsoft Software license agreement carefully, and then select the I accept check box to install the execution agent that provides you with the necessary prerequisites to test the hybrid and native mobile applications, and Windows desktop applications. Click Next to continue.
    Note: After the installation, the execution agent starts automatically when you run AFT test suites and it stops after the playback is completed.
  7. Browse for the location or directory where you want to install the product, and then click Next.
    Note: You must select any other directory if the default directory is not empty. The default locations for 32-bit and 64-bit installers are as follows:
    • For 32-bit: C:\Program Files(x86)\HCL
    • For 64-bit: C:\Program Files\HCL
  8. 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
  9. Read through the installation details and, then click Install.
  10. Click Done after the installation of the product is complete.

Results

You have installed the agent on your computer.