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. By default, the logs are located in the root folder of the Qt License Server executable.

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 contains the correct license numbers. For more information, see Maintain access control lists.

Online mode

With the on-premises Qt License Server operating in online mode, 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 mode

With the on-premises Qt License Server operating in offline mode, 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 on-premises configuration file

Make sure 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, make sure that 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

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

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

If you're using an on-premises Qt License Server operating in online mode, make sure that it's able to connect to Qt Cloud. The on-premises instance needs to connect to the following services:

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