Installing Agent in the GUI mode on macOS

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 mac machine, you must install HCL OneTest™ Performance Agent.

Before you begin

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:

Note: When you run a test or schedule by using HCL OneTest™ Performance Agent on macOS, by default, the majordomo.log file is stored in the $TMPDIR.

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:

/Application/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. Extract the downloaded product installer file.
  3. Double-click the installer to initiate the installation process.

    The GUI window is displayed.

  4. Initiate the GUI installation from the command line by completing the following steps:
    1. Change the directory to where you have downloaded the installer by running the following command: 
      cd <directory path>

      By default, the package is downloaded to /Users/Applications/HCL. For example, cd HCL-OneTest-UI-Mac-v10.1.2.app/Contents/MacOS/

    2. Run the following command to initiate the product installation: 
      ./<product name>

      For example, ./HCL-OneTest-UI-Mac-v10.1.2

  5. 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.

  6. Read through the details on the Introduction window, and then click Next.
  7. Read the license agreement carefully, select the I accept checkbox, and then click Next.
  8. Browse for the location or directory where you want to install the product, and then click Next.
    Note: By default, the product is installed at the following location: /Applications/HCL.
  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. Read through the installation details and, then click Install.
  11. Click Done after the installation of the product is complete.

Results

You have installed the agent on your computer.