Diagnose On-Prem Qt License Server

If you're having issues with license reservations on On-Prem 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 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.

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.

Check the connection to the Qt cloud

On-Prem Qt License Server synchronizes license information with the Qt cloud, so ensure it can reach the following services:

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

For more information, see Outbound connections.