Troubleshooting
You can troubleshoot some common issues you encounter with HCL Local License Server (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
- 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.
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.
- 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.
Failed to decrypt the TLS key.
Cause: When the encrypted certificate file is used during LLS certification and if openssl is not installed.
Resolution: As specified in System Requirements, ensure that OpenSSL is installed in the same machine where LLS is installed if encrypted tls key file is used.