Home
Administrator Guide
This guide describes how to install HCL OneTest™ UI software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
License management
Licensing for HCL OneTest™ UI is administered through HCL Software License & Download portal. This portal is a FlexNet-based web application that helps to manage software entitlements and licenses.
License configuration
To start using a product, you must first apply a license.

Administrator Guide
This guide describes how to install HCL OneTest™ UI software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
- Installation
  You can find information about the installation of HCL OneTest™ UI.
- License management
  Licensing for HCL OneTest™ UI is administered through HCL Software License & Download portal. This portal is a FlexNet-based web application that helps to manage software entitlements and licenses.
  - License descriptions
    The usage of base product and test extensions are enabled by floating licenses, whereas schedule runs can be enabled by either floating or consumption-based licenses. With floating licenses, multiple users can use the product; however, the total number of concurrent users cannot exceed the number of floating licenses you purchase.
  - License configuration
    To start using a product, you must first apply a license.
    - Configuring licenses by using a cloud-based License Server
      You can apply license by using a cloud-based License Server to use HCL OneTest™ UI.
    - Configuring licenses by using a Local License Server
      You might not be able to connect your computer to the internet due to certain restrictions. In such cases, you can configure a Local License Server (LLS) behind a firewall to use HCL OneTest™ UI.
    - Configuring licenses by using a Proxy Server
      You can connect directly to a cloud-based license server when you start HCL OneTest™ UI for the first time. As an alternative, you can configure HCL OneTest UI to use a Proxy Server.
  - Collecting usage metrics data
    To provide an insight into the usage patterns of the product itself and not necessarily the application that it is testing, the usage metrics are collected. The product can collect the metrics about the usage of the tool including and not limited to the number of tests executed, the number of actions performed against an application under test, the number of successful versus failed actions, verification points, and so on.
- Starting HCL OneTest™ UI from the command line
  You can start HCL OneTest™ UI from the desktop environment or a command-line interface.
- Integrations in UI Test perspective
  In this section, you will learn about the supported integrations for the Web UI Test perspective.
- Integrations in Functional Test perspective
  In this section, you will learn about the supported integrations for the Functional Test perspective.

License configuration

To start using a product, you must first apply a license.

When you start the product for the first time, a licensing dialog box is displayed. Specify the server ID that was provided to you or copy the ID from the HCL® License & Delivery portal. When you submit the server ID, the product connects with the HCL® License & Delivery portal to verify it and if there is a license available, it is checked out so that you can use the product. If the license is not available, a message is displayed about it. In most cases, you must not change the server URL in the licensing dialog.

Notes:

If the license is not used for 15 minutes, the license is returned to the server for others to consume it. If the product looses connectivity to the HCL® License & Delivery portal, you can use the product for two hours only if the server ID that you entered last time is correct.
After the product installation, when you apply the license to the product, the license information is cached in a system directory. If there are any permission issues accessing the directory or the directory is deleted, there can be licensing error when starting the product. The workaround is to create an environment variable HCL_ONETEST_LICENSING_STORAGE and specify a directory path. The licensing information is now stored in the new directory. For example,

You can also apply the license after you open the product by using any of the following methods based on your requirement:

To apply the license without opening the product, add the licensing parameters as environment variables:

Variables	Values
HCL_ONETEST_LICENSING_URL	https://hclsoftware.compliance.flexnetoperations.com
HCL_ONETEST_LICENSING_ID	Enter your server ID. The ID is a 12-character alphanumeric identifier.

When running the tests from command line, you do not have to specify any licensing argument. However, when running a schedule for HCL OneTest™ Performance or accelerated/distributed tests for HCL OneTest™ UI in an uninterrupted mode, you must specify vmargs -Dhptcostconfirm argument in the command. The uninterrupted mode refers to any of the non-GUI based test execution scenarios such as the following use cases:

Running a test from the command line
Running a test with Jenkins
Running a test with Ant
Running a test with UrbanCode™ Deploy
Running a test with IBM® Rational® Quality Manager