1.3.3. Licensing

To use the Axivion Suite, a valid license must be detected. The following mechanisms are supported:

  • Connection to Qt License Server

    • license server in the cloud: https://qls.qt.io

    • on-premise license server installation

  • License Key Files

1.3.3.1. Connection to Qt License Server

Licenses supplied by the Qt License Server (QLS) are supported from Axivion Suite 7.11.0 on. Please check with your Axivion Administrator to find out if your company is using QLS.

To setup the connection to the QLS, please run the script setup_qls from an Axivion command prompt. This script will interactively ask for details to be entered. By default, it will assume the cloud license server https://qls.qt.io holds the license.

To use an on-premise QLS, please install Qt License Server X.Y.Z (on-prem) via the Qt Online Installer (or Maintenance Tool, if you already have a Qt installation). Refer to the documentation installed with it. To connect to the server, you will need a qtlicd.ini file. If you have set up other clients to the QLS, please use your existing file. If not, copy and modify the template provided in BAUHAUS/templates/qtlicd.ini. This config file needs to be placed in the directory:

  • on Windows: %APPDATA%\Qt\qtlicd\qtlicd.ini

  • on Linux: $HOME/.local/share/Qt/qtlicd/qtlicd.ini

  • on macOS: $HOME/Library/Application Support/Qt/qtlicd/qtlicd.ini

Run setup_qls with the parameter --accept_non_default_server_addr to accept the manual configuration.

To run the setup_qls script in a non-interactive mode use the parameter --run_headless_or_fail. This will make the script rather fail than starting interactive queries. Please accept the terms and conditions by supplying the command-line switch --auto_accept_terms_and_conditions. If you are connecting to the cloud server https://qls.qt.io, please define the environment variables QT_ACCOUNT_LOGIN_EMAIL and QT_ACCOUNT_LOGIN_PASSWORD with the credentials of your Qt Account prior to running the script.

Run axivion_support and check its output on License Information to ensure the connection to the license server works.

1.3.3.2. License Key Files

License keys were the preferred license mechanism for the Axivion Suite up to version 7.11.x. They can still be in use in your setup, please contact your Axivion Administrator to find out if your company has been supplied a license file by The Qt Company GmbH, a subsidiary of The Qt Group.

The license key file may be placed in any directory as follows:

1. Any directory specified by the environment variable BAUHAUS_CONFIG (this could be on a project-specific location, even on a shared network drive). Please see Section Configuration Files for details on BAUHAUS_CONFIG.

  1. In the implicit configuration layer directories for the installation of the Axivion Suite:

  • Windows: BAUHAUS\config

  • Linux/macOS: BAUHAUS/config

  1. In the user configuration layer directory:

  • Windows: %USERPROFILE%\.bauhaus

  • Linux/macOS: $HOME/.bauhaus

All files with the extension .key are assumed to be Axivion Suite license key files and their contained valid license features are united.

Caution

The license key must be in one single line. Line breaks in the license key may render the license invalid.