Troubleshooting Qt License Server
The following table describes typical problems that might occur when you perform Qt License Server operations from the command-line interface and suggests possible solutions to them.
Note: If you're having issues with license reservations, you can contact Qt Support. In Qt Customer Portal, select Support Center and Create a request.
| Issue | Possible cause | Solution |
|---|---|---|
| The command to release licenses responds with the error code 400 or the message "Encountered an error when manually releasing all unreleased floating reservations". | Manual garbage collection does not work. | Qt License Server starts automatically garbage collection and releases reservations. |
Internal server error when running the export command. | You might have run the export command using unsupported data format for startDate and endDate. | Check the start and end date format and run the command again. For more information, see Export reports. |
| Cannot export reports for older licenses after fetching new licenses. | No data is found when you try to export report after fetching new licenses. | Export all reports before fetching new licenses. |
| Cannot export reports after offloading logs, usage data, and statistics. | No data is found when you try to export reports after offloading logs, usage data, and statistics. | Export all reports before offloading data. |
| Licenses are locked on a deleted machine and cannot be used anymore. | User deleted the machine hosting On-Prem Qt License Server and forgot to deregister the licenses. | Try to set up the same machine again with the same configuration. If this is unsuccessful, contact Qt to deregister those licenses. |
| A proxy server blocks Qt License Server traffic. | Qt License Service doesn't use the local proxy configuration. | Configure Qt License Service to honor the proxy configuration. In Qt License Service version 3.5.0 or later, configure the proxy settings in the Qt License Service configuration file. For more information, see proxy_url in Configuration file: qtlicd.ini. |
License reservation related errors
| Error message | Solution |
|---|---|
| "License request timeout. Server is busy serving other requests." | Wait for a moment and try again. If the issue persists, contact your local license admin or Qt Support. |
| "Authentication invalid. Log in again." | Log in to your Qt Account again with Qt Online Installer, Qt Maintenance Tool, or with the command-line tool qtlicensetool(.exe) using the command:<Qt SDK>/Tools/LicenseService/qtlicensetool(.exe) --login |
| "Invalid license reservation request. Unable to proceed." | Install your Qt tools again. If the issue persists, contact Qt Support and attach the error log to your support request. |
| "Authentication missing. Unable to proceed." | Install your Qt tools again. If the issue persists, contact Qt Support and attach the error log to your support request. |
| "Server rate limit exceeded. Too many requests from your address." | Wait for a moment and try again. If the issue persists, contact your local license admin or Qt Support. |
| "The server operation has stopped due to not being in sync with the Qt license back end." | Contact your local license admin and ask them to check the On-Prem Qt License Server operation. |
| "No suitable license available for the application. Your application is not covered by the licenses available to you." | Check your licenses in Qt Customer Portal or contact your license admin. |
| "No license seats available for licenses." | Wait until others release seats, or ask your local license admin for more seats. |
| "The user is on the deny list for available licenses." | Contact your local license admin. |
| "The licenses available to the current user have expired." | Check your available licenses in Qt Customer Portal or contact your local license admin. |
Admins: On-Prem Qt License Server related errors
| Error message | Description | Solution |
|---|---|---|
| "Node-locked licenses cannot be registered on on-prem servers." | You tried to register node-locked offline licenses on On-Prem Qt License Server. Node-locked licenses are not supported by On-Prem Qt License Server. | To revert the node-locking for a license, contact Qt Support. For more information, see Manage license node-locking. |
| "Node-locked licenses will be skipped and cannot be registered." | You tried to register node-locked offline licenses on On-Prem Qt License Server. Node-locked licenses are not supported by On-Prem Qt License Server. | To revert the node-locking for a license, contact Qt Support. For more information, see Manage license node-locking. |
| "The requested license IDs are not correct." | The provided license IDs are not valid. | Verify the correct license IDs from Qt Customer Portal and try to register the licenses again. |
| "Failed to update the on-prem licenses." | The automatic license sync from Qt Cloud failed. This can happen, for example, due to network issues. Note: If the connection to Qt Cloud can't be established in 7 days, the On-Prem Qt License Server instance stops serving license reservations to client applications. | Check the On-Prem Qt License Server system logs for more details. Also, ensure the authentication has not expired. |
| "The given licenses are already registered by other on-prem instances." | Another On-Prem Qt License Server instance already uses some of the license IDs. A license can be used only on one On-Prem Qt License Server instance at a time. | Deregister the licenses on the On-Prem Qt License Server instance where they are registered and then try again. If the machine used to register the license IDs doesn't exist anymore and the licenses were not deregistered correctly, contact Qt Support. |
Known issues
- Qt License Server 3.4.0:
- With Qt License Server on Windows, the Qt logo and properties are not loaded for
qt-license-server.exe. For more information, see QLS-1780. - The
qt-license-server.execommand-line tool returns incorrect status calculations due to a flaw in its internal logic and data handling. The issue is fixed in Qt License Server 3.5.0.
- With Qt License Server on Windows, the Qt logo and properties are not loaded for
See also Diagnose Qt License Server, Qt License Server command-line interface, and Troubleshooting Qt License Service.
© 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.
