Welcome
Administrator Guide
This guide describes how to install HCL DevOps Test UI (Test 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 DevOps Test UI (Test 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
You must first apply a license to start using HCL DevOps Test UI (Test UI).

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test UI (Test UI). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL DevOps Test UI (Test UI) 2024.03 (11.0.1).
Getting Started Guide
This guide provides an overview of HCL DevOps Test UI (Test UI). You can find the task flows to get you started with Test UI. This guide is intended for new users.
Tutorials
You can learn to start using Test UI by reviewing the information in the Tutorials for the UI Test perspective and Functional Test perspective.
Samples
You can find the sample project that you can use with HCL DevOps Test UI (Test UI) to test the functionality of an application.
Administrator Guide
This guide describes how to install HCL DevOps Test UI (Test 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 DevOps Test UI (Test UI).
- License management
  Licensing for HCL DevOps Test UI (Test 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 description
    You require floating seat licenses to use HCL DevOps Test UI (Test UI). If you want to run AFT Suites or parallel execution of tests on more than 5 channels, you require execution licenses.
  - License configuration
    You must first apply a license to start using HCL DevOps Test UI (Test UI).
    - Configuring licenses by using a cloud-based License Server
      You can apply license by using a cloud-based License Server to use HCL DevOps Test UI (Test 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 DevOps Test UI (Test UI).
    - Configuring licenses by using a Proxy Server
      You can connect directly to a cloud-based license server when you start HCL DevOps Test UI (Test UI) for the first time. As an alternative, you can configure Test 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 DevOps Test UI from the command line
  You can start HCL DevOps Test UI (Test UI) from the desktop environment or a command-line interface.
- Software configuration management
  You can integrateHCL DevOps Test UI (Test UI) with the software configuration management systems to maintain an auditable and repeatable history of your organization's test assets.
- 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.
Test Author Guide
This guide describes how to create test scripts and enhances them by applying different test elements such as dataset, variables, and verification points.
Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM Cloud Private, Jenkins and so on. The test results can be pushed to HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).
Test Manager Guide
This guide describes how to keep track of the performance of the application by evaluating the test results. Following topics cover how you can work with the test results.
Troubleshooting
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL DevOps Test UI (Test UI).
Reference Guide
This guide describes the additional topics to gain more knowledge about HCL DevOps Test UI (Test UI).
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL DevOps Test UI (Test UI) as a PDF file.
Security Considerations
You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

License configuration

You must first apply a license to start using HCL DevOps Test UI (Test UI).

When you start Test UI for the first time, a licensing dialog 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_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_LICENSING_URL	https://hclsoftware.compliance.flexnetoperations.com
HCL_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 DevOps Test Performance or accelerated/distributed tests for HCL DevOps Test 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 HCL DevOps Deploy
Running a test with IBM® Engineering Test Management