Troubleshooting licensing issues
After you set up and apply licenses for HCL OneTest™ API, you can troubleshoot issues with licensing by setting up logs.
Enabling the licensing debug logs
You can enable the licensing debug logs by performing the following steps:
- Open the it-logging.properties file that is located in the HCL OneTest™ API installation directory.
- Add the following attribute with the value set to INFO in
the it-logging.properties
file:
com.hcl.products.test.common.licensing.key.level=INFO
- Save and close the it-logging.properties file.
- Add the following environment variable:
Environment variable Value HCL_ONETEST_LICENSING_DEBUG true - Start HCL OneTest™ API from the command line by using the -console parameter.
The FlexNet Local License Server generates a log file. The default location in the
different operating systems is as follows:
- On Windows, the path is as follows: c:\windows\ServiceProfiles\NetworkService\flexnetls\HCL\logs\flexnetls.log
- On Linux, the path is as follows: /var/opt/flexnetls/HCL/logs/flexnetls.log
Enabling storage of licensing information
After the product installation, when you apply the license to the product, the
license information is cached in a system directory. A licensing error is displayed
when you start the product in the following conditions:
- There are any permission issues accessing the system directory.
- The system directory is deleted.
To prevent any licensing error due to issues with the system directory, perform the
following steps:
- Add the following environment variable:
Environment variable Value HCL_ONETEST_LICENSING_STORAGE Specify a directory path The licensing information is then stored in the directory. For example, the directory can be C:\Users\<username>\HCLOneTest.