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 Installation Manager from the jazz website. For more information about installing the product from the command-line interface in the silent mode, see IBM Installation Manager Knowledge Centre.
You must ensure that you have connected to the Internet.
About this task
-
To use the response time breakdown feature in HCL OneTest™ Performance Agent V8.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
- Open Installation Manager.
- Click OK. to add a repository link to the product's setup disk, and then click
- Click Install.
-
Click a product package.
The description of the product package is displayed in the Details pane at the end of the window.
- 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.
- 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.
-
Select the product package and its updates, 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.
-
Read and understand the terms of all of the license agreements for the selected
package, and then perform the following steps:
- Click I accept the terms in the license agreement.
- Click Next to continue.
-
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 : C:\Program Files\HCL\HCLIMShared
-
For : /opt/HCL/HCLIMShared
-
For : /Applications/HCL/HCLIMShared
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. -
-
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 update the product.
- 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. -
Perform the following steps to create a new package group:
-
Click Next.
HCL OneTest™ Performance Agent does not support extending an existing Eclipse IDE.
-
Select the languages for the package group.
The corresponding translations for the user interface and documentation for the product package are installed.
-
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 the Windows desktop Application testing (Next
Generation) and Appium Drivers for Automated
Testing 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 installation, the UI Test Agent starts to run automatically on your computer. On Windows computer, the UI Test Agent starts to run automatically whenever you restart your computer and also when you start the product. On Linux and macOS, the UI Test Agent starts to run automatically whenever you play back tests. For more details, see the related links.Note: After the installation, the UI Test Agent automatically starts whenever you run the AFT suites and it stops when the playback is completed.
-
Select Show Dependencies to view the dependency relationships between features.
-
Click a feature to view its brief description under Details.
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.
- Select the Windows desktop Application testing (Next
Generation) and Appium Drivers for Automated
Testing 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.
-
Perform the following steps to configure the agent:
-
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.
- 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.
- Click Finish to exit the installation wizard.