Diagnose Qt License Server

If you're having issues with license reservations, 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 depend 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 Maintain access control lists.

On-Prem Qt License Server

With On-Prem Qt License Server, check the license IDs for the used Qt Account from Qt Customer Portal:

1. Go to Qt Customer Portal.
2. Check the license IDs for your available licenses.
3. Check that the required licenses have not expired.

Offline Qt License Server

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.

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. For more information, see SSL certificates.

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 On-Prem Qt License Server or Offline Qt License Server instance.
• There are no firewall restrictions that could block the access.
• The user account running the On-Prem Qt License Server or Offline Qt License Server instance has write access to the folder where it is installed.

If you're using On-Prem Qt License Server, ensure it can connect to Qt cloud. The On-Prem Qt License Server instance needs to connect to the following services:

• login.qt.io (port: 443)
• qls.qt.io (port: 443)
• licenses.qt.io (port: 443)