Diagnose Offline Qt License Server

If you're having issues with license reservations on Offline Qt License Server, try diagnosing the problem with these steps.

If you have a specific issue, see Troubleshooting Qt License Server.

Check the logs

Investigate the Qt License Server logs for possible errors. The location of the Qt License Server logs depends on your operating system.

journalctl -u qt-license-server.service

journalctl -u qt-license-server.service -n 100

Change the logging level

To modify the logging level, edit the QLS_LOG_LEVEL option in the Qt License Server configuration file (Linux: qt-license-server.service, Windows: qt-service.xml). For more information, see Qt License Server configuration. Remember to restart Qt License Server after the modifications.

Check the license IDs and expiry dates

If you've enabled ACLs, check that the acl.json file contains the correct license numbers. For more information, see Manage ACLs.

With Offline Qt License Server, check the license IDs from the entitlement.json file:

1. Open the entitlement.json file.
2. Check the license_id for each license in the file.
3. Check the valid_to so that each license has not expired.

For more information, see Compose entitlement.json from multiple licenses.

Check the license node-locking

Offline Qt License Server reads a node-locked entitlement.json file. If the fingerprint of the host computer no longer matches the one the license file was locked to, reservations fail. For more information, see Manage license node-locking.

Check the configuration file

Ensure you have configured the Qt License Server configuration file (Linux: qt-license-server.service, Windows: qt-service.xml) properly.

Some common misconfigurations are:

• QLS_PORT
  • Check that the QLS_PORT you have specified here is not occupied by anything else and is free to be used.
  • Check that this QLS_PORT is accessible via HTTP(S).
• QLS_ENABLE_SSL
  • In localhost testing environments, set this to no.
  • In production, ensure you have the certificate from a Certificate Authority installed on the computer hosting Qt License Server, and that cert.pem and key.pem are in the Qt License Server root folder.

For more information, see Qt License Server configuration.

Check host computer configuration

Ensure you have configured the computer hosting Qt License Server properly. Start by checking that:

• The QLS_PORT is free and accessible via HTTP(S) from outside the computer hosting the instance.
• There are no firewall restrictions that could block the access.
• The user account running the instance has write access to the folder where it is installed.