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

Issue Possible cause Solution

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.

Issue	Possible cause	Solution
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.

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 message	Issue	Possible cause	Solution
Not able to read settings	Qt 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 service	The Qt or QA product can't 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.
Could not initialize client socket: TCP: Error while resolving the hostname: <reason>	The Qt or QA application can't connect to Qt License Service.	The host computer's configuration does not allow access to localhost.	Check that your network configuration allows connections to `localhost/127.0.0.1`. This is where Qt License Service is running and the client application attempts connecting to in order to acquire a license. Check that your firewall configuration does not block connections to `localhost/127.0.0.1`.

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 code Issue Solution

202

Qt License Service cannot connect to Qt License Server.

Error code	Issue	Solution
202	Qt 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.
203	The product does not accept the user's credentials.	Check that the qtaccount.ini file has the user's Qt Account credentials.
208 - SslVerifyError	Qt 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.

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.

203 The product does not accept the user's credentials. Check that the qtaccount.ini file has the user's Qt Account credentials.

208 - SslVerifyError Qt 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:

LinuxmacOSWindows

qtlicd --mode cli --log-level silly

qtlicd --mode cli --log-level silly

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

Copying a Qt or QA installation to another computer

If you copy a Qt or QA installation to another computer, the commercial license checks fail unless you do the following steps:

LinuxmacOSWindows

Copy the <QtSDK>/Tools/LicenseService folder to the target computer.
Run:
```
<QtSDK>/Tools/LicenseService --register
```
Copy the qtlicd.ini file to the correct location.
Test the Qt License Service installation by pinging the server:
```
<QtSDK>/Tools/LicenseService/qtlicensetool -S
```

Copy the <QtSDK>/Tools/LicenseService folder to the target computer.
Run:
```
<QtSDK>/Tools/LicenseService --register
```
Copy the qtlicd.ini file to the correct location.
Test the Qt License Service installation by pinging the server:
```
<QtSDK>/Tools/LicenseService/qtlicensetool -S
```

Copy the <QtSDK>\Tools\LicenseService folder to the target computer.

Run:

<QtSDK>\Tools\LicenseService.exe --register

Copy the qtlicd.ini file to the correct location.
Test the Qt License Service installation by pinging the server:
```
<QtSDK>\Tools\LicenseService\qtlicensetool.exe -S
```

Warning: We do not recommend manually copying Qt License Service to another computer. If Qt License Service is manually copied to another computer, Qt Maintenance Tool is not present, which prevents automatic updates for Qt License Service.

Qt License Service operation What's new

© 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.