Install client-side tools Uninstall Qt License Server

Update Offline Qt License Server

The following steps describe how to update Offline Qt License Server from version 3.x.x to the latest version.

Linux Windows

Prerequisites:
- Obtain the latest Qt License Server binary package.
- Obtain the updated qt-license-server.service file.
- Ensure that you have sudo/root access to the license server.
- Set QLS_MAX_QUEUE_SIZE to the maximum recommended value of 100000 for the grid system.
- We recommend keeping all other configuration settings as their default values in the configuration file.
Verify the current service status:
```
sudo systemctl status qt-license-server.service
```
Check which version is currently installed:
```
./qt-license-server version
```

Stop the current Qt License Server:

sudo systemctl stop qt-license-server

Verify that it has stopped:

sudo systemctl status qt-license-server.service

Back up the current installation:

cd /opt/qt-license-server/
mkdir -p ~/backup-qls
cp qt-license-server ~/backup-qls/
sudo cp /etc/systemd/system/qt-license-server.service ~/backup-qls/

Back up the current database files (data.sqlite, data.sqlite-wal, and data.sqlite-shm) and logs. If you haven't specified a custom path for logs, the default paths are:
- database: /opt/qt-license-server
- logs: /opt/qt-license-server/logs

Replace the Qt License Server binary:

sudo cp <path-to-downloaded-QLS>/qt-license-server /opt/qt-license-server/
sudo chmod +x /opt/qt-license-server/qt-license-server
ls -l /opt/qt-license-server/qt-license-server

Update the systemd service configuration. Merge the supplied qt-license-server.service file with the existing deployment configuration, preserving any environment-specific or custom values, especially QLS_PORT, QLS_ENABLE_SSL, and QLS_LOG_LEVEL. Then copy the updated service file and reload systemd:
```
sudo cp <path-to-downloaded-QLS>/qt-license-server.service /etc/systemd/system/qt-license-server.service
sudo systemctl daemon-reload
```

Start the service:

sudo systemctl start qt-license-server.service
sudo systemctl enable qt-license-server.service
sudo systemctl status qt-license-server.service

Validate server connectivity:

curl -v http://localhost:8080/
curl -v http://127.0.0.1:8080/

Alternatively:

sudo ss -tlnp | grep 8080
sudo netstat -tlnp | grep 8080

Replace 8080 with the configured QLS_PORT value if your deployment uses a different port.

Monitor server logs. Follow the service logs in real time:
```
journalctl -u qt-license-server -f
```
Or display the last 100 log entries:
```
journalctl -u qt-license-server -n 100
```

Prerequisites:
- Obtain the latest Qt License Server binary package.
- Check the latest qt-service.xml file for the newly introduced configuration options.
- Ensure you have admin rights to install the license server.
- We recommend keeping all other configuration settings as their default values in the configuration file.
Stop the current Qt License Server:
```
qt-service.exe stop
```
Verify that Qt License Server has stopped:
```
qt-service.exe status
```
Back up the current database files (data.sqlite, data.sqlite-wal, and data.sqlite-shm) and logs. If you haven't specified a custom path for logs, the default paths are:
- database: <QtSDK>\LicenseManagementTools\QtLicenseServer\<version>\LicenseService\<platform>
- logs: <QtSDK>\LicenseManagementTools\QtLicenseServer\<version>\LicenseService\<platform>\logs
Uninstall the current Qt License Server.
```
qt-service.exe uninstall
```
Update the Qt License Server configuration: Merge the supplied qt-service.xml file with the existing deployment configuration, preserving any environment-specific or custom values, especially QLS_PORT, QLS_ENABLE_SSL, and QLS_LOG_LEVEL.
Check the Qt License Server version.
```
qt-license-server.exe version
```
Install the new Qt License Server version:
```
qt-service.exe install
```
Copy the backed-up database files to the new Qt License Server version directory.
Start the server with the new qt-service.xml configuration file with migrated settings:
```
qt-service.exe start
```

Copy the existing or a new license file to the latest Qt License Server directory.

Warning: License files for Qt License Server 3.5.x are not supported on Qt License Server 3.6.x and later.

Verify that the installed Qt License Server version is running:
```
qt-service.exe status
```

Install client-side tools Uninstall Qt License Server

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