Installing and activating licenses in the virtual environments via KMS server.

In order to install and activate Lycia licensing in any virtual environment, please follow the steps below:

1. It is necessary to prepare the physical host for the deployment of the KMS server. KMS Server is server software that provides licensing management in virtual environments.

2. The KMS server starts automatically after the installation. The KMS server can be installed using QPM command line tool or using QPM GUI (available only for Windows).

• To install KMS server preset (KMS Server and Runtime components) using command line tool, download QPM CLI and execute the following command:

Open

C:\Users\user\Downloads>qpm install kms-server

Open

sudo ./qpm install kms-server

• To install KMS server preset using graphical interface, download QPM GUI and select KMS preset in order to install KMS Server component along with Runtime component:

3. Activate the license on the host machine (full information on how to activate the commercial license and the trial license).

4. Run the KMS server with the license. To do this, execute the following command from $LYCIA_DIR/bin:

qxlm --kms

5. For the virtual environment where Lycia is installed, specify the KMS host for the license management. There are two ways to do this:

• In a virtual environment where Lycia is installed, add QX_KMS_HOST variable to the system environment and restart the Web server and Lycia Studio.

• In a virtual environment where Lycia is installed, add QX_KMS_HOST=<IP address> variable with the respective value to the project's properties for compilation and to the inet.env for Runtime. Where <IP address> is the IP address of the host machine where Runtime with the KMS server is installed.

6. Now, if any of the license’s consumers such as qfgl or qrun is run inside a virtual environment, the license management is performed via the KMS server without using a local license.