Troubleshooting¶
The steps on this page are recommended when troubleshooting Squish with licenses from a Qt License Server (QLS). For more information please refer to the QLS manual .
Verify that Squish is configured to use QLS¶
The Squish license file in ~/.squish-license must contain this snippet: (There may be additional information around it.)
"v2": {
"format": "qls"
}
Check operation of the QLS client service¶
Basic communication with the QLS server can be checked by collecting two bits of information:
Squish-side logs¶
Before trying this, Squish IDE, squishrunner and/or Qt Creator must be shut down. Then wait 60 seconds to be sure that the Qt license service (not server) has shut down as well. Afterwards execute squishrunner from the command line as follows. For Linux and macOS shells:
QTLICD_CLIENT_LOG_TO_STDOUT=true QTLICD_LOG_LEVEL=debug ./bin/squishrunner --info wrappers
On Windows:
cmd /C "set QTLICD_CLIENT_LOG_TO_STDOUT=true && set QTLICD_LOG_LEVEL=debug && .\bin\squishrunner.exe --info wrappers"
The prepended environment variables enable Qt license service output to be printed directly to the terminal ( more details ). These will only take effect if the Qt license service was not already running, therefore the need to wait earlier.
On success, the following text will be printed at the end of the output:
squishrunner: Error while retrieving information: wrappers
Could not connect to Squish server at host 127.0.0.1, port 4322: Unknown Error
This is expected. We didn't also start a squishserver process, but up to this point squishrunner has already checked for a license. If you do not see above message, please send the full output to Squish support.
QLS service logs¶
Collect corresponding Qt license service logs. The file is located in the Squish installation directory: $SQUISHDIR/qls/service/logs/qtlicd.log.
(If you have multiple Squish packages installed, the current logs may be located in the same file in a different Squish package from what you were using last.)
Verify or adjust the QLS URL used by the QLS client service¶
If the Qt License Server URL needs to be adjusted after installation you can use qtlicensetool to do that. It is located at $SQUISHDIR/qls/service/qtlicensetool.
- To see the current QLS URL:
qtlicensetool --get-server-address - To set a new QLS URL:
qtlicensetool --set-server-address <url>
Make sure to double-check if your server supports http or https. If QLS runs on a non-standard port that must be specified here as well (e.g. http://qls.example.org:8080).