Troubleshooting Qt License Service

If users have problems with fetching licenses when starting Qt and QA products, such as Qt Creator or Squish, Qt License Service and the products might show them error messages and codes. The following sections describe typical problems and suggest possible solutions to them.

Qt License Service issues

IssuePossible causeSolution
The user cannot access all the licensed features.The local cache on the computer might have an old version of the license.Clear the license cache, and then start the Qt or QA product to fetch a new license.
Qt License Service running in on-demand mode does not shut down automatically.The Qt or QA product process might be kept alive by an association to a TCP connection or port after the product crashes or is shut down, which stops Qt License Service from shutting down.Use the tools of the operating system to stop the qtlicd process.

For example, on Linux and macOS, enter: killall qtlicd.

On Windows, enter taskkill /IM qtlicd.exe, or locate and end the task in Task Manager > Processes.

Qt License Service error messages

Error messageIssuePossible causeSolution
Not able to read settingsQt License Service does not start.The user might have deleted the settings file that has the Qt License Server address.Create a new qtlicd.ini file and set the Qt License Server address as a value of server_addr.
Not able to get the executable path for license serviceThe Qt or QA product cannot fetch a valid license.The tools.licenseservice installer component might not be installed correctly.Check that the qtlicd executable is installed in the correct place and its location is set as the value of path in the installations.ini configuration file.

Qt or QA product error codes

When users try to start a Qt or QA product, it might fail with the following error codes.

Error codeIssueSolution
202Qt License Service cannot connect to Qt License Server.If Qt License Service cannot fetch licenses, check that:
  • The computer is connected to the Internet.
  • Firewalls don't block the connection.
  • Qt License Server certificate is available on the computer. For more information, see SSL certificates.

If this does not help, check the Qt License Service logs.

203The product does not accept the user's credentials.Check that the qtaccount.ini file has the user's Qt Account credentials.
208 - SslVerifyErrorQt License Server might be configured to use HTTP instead of HTTPS.If the on-premises Qt License Server is configured to use plain HTTP, use HTTP in the server_addr value in qtlicd.ini, too.

Debugging Qt License Service operation

Start Qt License Service in the current shell in debug mode to see service operation details when you start Qt or QA products to trigger a license reservation. This might help you to pinpoint potential issues. If you create a support request to Qt support, attach the full report to it.

To start Qt License Service with the log level silly:

qtlicd --mode cli --log-level silly
qtlicd --mode cli --log-level silly
qtlicd.exe --mode cli --log-level silly

See also Diagnose Qt License Service, Qt License Service configuration, Qt License Service operation, and Supported Qt and QA products.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.