Troubleshooting

You can troubleshoot some common issues you encounter with HCL Local License Server (LLS).

The following logs are created that you can use to troubleshoot errors while using LLS.

Error log - The system logs installation errors when there's a fingerprint mismatch, TLS certificate issues, and so on. These errors are captured in the installed_directory/logs/hcl_lls.log file.
Features log - The installed_directory/logs/hcl_lls_features.log file covers the details of the leases, current state of a pool, and so on.
Pools log - The installed_directory/logs/hcl_lls_pools.log file is updated when you add or remove your license file in the license folder. The pools log file contains all active pools generated for your license.

The following tips help you troubleshoot some of the issues that you may encounter:

`OpenSSL is not installed or not found in the system's PATH`

Cause: When running the utility program for TLS certificate generation in any of the following scenarios:

Scenario 1 - When OpenSSL is not installed.
Scenario 2 - When you have installed OpenSSL but have not set the PATH variable.
Scenario 3 - When you have installed OpenSSL and have also set the PATH variable. This issue is with OpenSSL issue when it is not able to read the OpenSSL configuration file.

Resolution: You must ensure that OpenSSL is installed, set the OPENSSL_CONF system environment variable to specify the path of the openssl.cfg file, and start the utility program again.

`Fingerprint mismatch`

Cause: When the fingerprint in the license file does not match with the fingerprint generated.

Resolution: You must generate the fingerprint again, download the license file, and use the license file for installation.

`TLS certificate is expired`

Cause: When you use an expired TLS certificate while installing LLS.

Resolution: Generate a new self-signed TLS certificate using the utility program or use a valid third-party certificate.

`Not able to stop Windows service`

Cause: On Windows, you cannot start services manually from the Services window.

Resolution: Stop the service by terminating its process and then start the service again from the Services window.

`Could not resolve host or curl: (51) SSL: no alternative certificate subject name matches target host name`

Cause: When the hostname is not included in the hosts file.

Resolution: You must add the hostname to the hosts file. The host file is available:

On Windows at C:\Windows\System32\drivers\etc location.
On Linux at /etc/hosts location.

`Failed to decrypt the TLS key. Please check the password and try again.`

Cause: The encrypted private key is either not provided or the password entered is incorrect.

Resolution: Provide the correct password for the encrypted private key to decrypt it.

Issue: In certain versions of RHEL & CentOS linux machines, the Local License Server service is not starting after the installation.

Cause: The issue might occur because SELinux is not set to permissive mode.

Resolution: Set SELinux to permissive mode. Refer to the Red Hat documentation for detailed information. If you do not have the necessary permissions, contact the system administrator to update the SELinux setting.