Installing HCL OneTest Performance Agent

You must install HCL OneTest Performance Agent on different computers to apply load on the server that hosts the application under test.

Before you begin

You must have installed IBM® Installation Manager. For more information. refer to the IBM Installation Manager Documentation.

About this task

Notes:
  • To use the response time breakdown feature in HCL OneTest Performance Agent 8.7 or later, uninstall the existing version of the agent and install it afresh.

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

  • You cannot upgrade to the latest version of the product. You must uninstall the existing version of the product before installing the latest version of the product.

Procedure

  1. Perform the following steps to install HCL OneTest Performance Agent from Installation Manager:
    1. Open Installation Manager.
    2. Click File > Preferences > Repositories to add a repository link to the product's setup disk, and then click OK.
    3. Click Install.
  2. Click a product package to highlight it.
    The description of the package is displayed in the Details pane at the end of the window.
  3. Optional: Click Check for Other Versions, Fixes, and Extensions to search for any updates to the product packages.
    If updates for a product package are found, they are displayed in the Installation Packages list under their corresponding product. Installation Manager displays only the recommended updates by default.
  4. Optional: Select the Show all versions checkbox to view all the updates that are available for the packages.
    You can click the package name to view the package description under the Details pane. 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. You can click the link to view additional information in a browser.
  5. Select the product package and its updates to install it on your computer, and then click Next.
    Note: Updates with dependencies are automatically selected and cleared together. If you install multiple packages simultaneously, all the packages are installed into the same package group.
  6. Read and understand the terms of all of the license agreements for the selected package, and then perform the following steps:
    1. Click I accept the terms in the license agreement.
    2. Click Next to continue.
  7. Select a location for the shared resources directory, and then click Next.

    The shared resources directory contains resources that can be shared with one or more package groups. You can either browse the location in the Shared Resources Directory field or enter the path of the location for the shared resources directory.

    The default path of the Shared Resources Directory are as follows:

    • For win_icon: C:\Program Files\HCL\HCLOneTest

    • For lin_icon: /opt/HCL/HCLOneTest

    • For mac_icon: /Applications/HCL/HCLOneTest

    Remember: You can specify the shared resources directory only for the first time when you install a package. You must use your largest disk for this directory. The largest disk ensures that you have adequate space for the shared resources of future packages. You cannot change the location of the directory unless you uninstall all packages.
  8. Select one of the following options to use an existing or new package group:
    • Use the existing package group: You can use this package group if you already created the package group.
    • Create a new package group: You can use this package group either to install or update the product.
    A package group represents a directory in which packages share resources with other packages in the same group.
    Note: The Use the existing package group option is disabled when you install a package for the first time.
  9. Perform the following steps to create a new package group:
    1. Select Create a new package group.
    2. Enter the path in the Installation Directory field for the package group.
      The name for the package group is created automatically.
      The default paths are as follows:
      • For win_icon: C:\Program Files\HCL\HCLOneTest
      • For lin_icon: /opt/HCL/HCLOneTest
      • For mac_icon: /Applications/HCL/HCLOneTest
    3. Select 32-bit or 64-bit as Architecture Selection.
    4. Click Next.
  10. Select all the features that you want to install, and then click Next.

    You can perform the following actions to install or view information about the features:

    • Select or clear checkboxes to enable or disable the features.

    • Select Show dependencies to view the dependency relationships between features.

    • Click a feature to view its brief description under the Details section.

    You can select the Windows desktop Application testing (Next Generation) and UI Test Agent checkboxes to install the UI Test Agent which provides the necessary prerequisites to test native and hybrid mobile applications, and Windows desktop applications.

    The UI Test Agent is installed along with HCL OneTest Performance Agent on your computer.

    Note: After the agent installation, the UI Test Agent starts to run automatically on your computer whenever you restart your computer. On Linux and macOS, you must set the environment variable to start the UI Test Agent automatically.
    Notes:
    • The Load Generation Agent is used to generate a load on the system under test and gather data for the Response Time Breakdown feature.

    • Installation Manager automatically enforces any dependencies with other features and displays updated download sizes and disk space requirements for the installation.

  11. Perform the following steps to configure the agent:
    1. Select HCL OneTest UI Panel if you shell-share HCL OneTest Performance with HCL OneTest UI and run a UI test on the remote agent computers.
      Notes:
      • On Windows system, clear the The agent will be used primarily to support remote execution of UI tests from HOT-UI checkbox if you are not running a UI test, so that Majordomo runs as a service.

      • On Linux and Mac operating systems, the The agent will be used primarily to support remote execution of UI tests from HOT-UI option is not available. The agent runs as a service and can run a UI test. This is the default behavior.

      • When Majordomo runs as a service, it starts the service automatically after the computer is restarted. However, if you want to run the UI test on remote agent computers, then you must select The agent will be used primarily to support remote execution of UI tests from HOT-UI checkbox so that after the installation of the agent is complete, Majordomo runs as a batch file instead of a service.

      • When Majordomo runs as a batch file, it stops after the computer is restarted. You must restart Majordomo by double-clicking the AgentInstallDir/Majordomo/Majordomo.bat file.

    2. Select HCL Load Generation Agent Configuration and perform the following steps:
      1. Specify the values for the following parameters for HCL OneTest Performance:
        Field name Description Example
        Workbench hostname The hostname of HCL OneTest Performance. localhost
        Workbench port The port number of HCL OneTest Performance. 7080
      2. Specify the values of the following parameters for HCL OneTest Server:

        Field name Description Example
        Server Hostname 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
        Server Port The port number of HCL OneTest Server. 443
        Server Token An offline user token that is created from HCL OneTest Server. eyJhbGciOiJIUzI1NiIsInR
        Server URL Alias The name of the Server URL Alias that you provided during the creation of the team space in HCL OneTest Server. testteam
    3. Click Next.
  12. Review your choices, and then click Install.
    You can click Back to change the choices that you made on previous pages and make your changes.
    A progress indicator shows the percentage of the installation that is complete.
  13. Optional: Click View Log File to open the installation log file for the current session in a new window.
    Note: You must close the Installation Log window to continue.
  14. Click Finish to exit the installation wizard.

Results

You have installed HCL OneTest Performance Agent.

What to do next

You can check the status of agents from HCL OneTest Performance. See Checking the status of agents.