License activation using Guardant key#

Note: This section describes license activation only using the Guardant key. Go to the section "License activation using HASP key" to read the corresponding instructions.

There are two methods for activation using the Guardant key — with Internet access on the server where you plan to activate the license, and without Internet access. The second method involves the use of an auxiliary server with Internet access.

Select the desired method and follow the appropriate link below:

There is access to Internet#

You should perform these steps, provided that there is an Internet connection on the server where license activation is required.

Sequencing with internet#

The sequence of actions to activate the license:

Request a license key from a VisionLabs representative.
Install and run Guardant Control Center.
Install a package intended to run front-end applications without physical output to the screen.
Activate the license.
Go to the Guardant user interface and save the license ID.
Specify your server address and license ID. This can be done using the following methods:
- Installation manual: in the "platform_settings.json" file before starting the LUNA PLATFORM installation or in the Configurator settings before starting the Licenses container.
- Upgrade manual: in the Configurator settings before starting the Licenses container.
- Installation using Docker Compose: in the "platform_settings.json" file before running the script.
Relevant documents contain reminders of the above actions.

The "Dongles" tab of the user interface (<server_host_address>:3189) displays activated keys.

Launch Guardant Control Center#

Note. When updating Guardant Control Center, you must re-issue the license key.

To activate the license, you need to launch the Guardant Control Center security key management service.

Go to the directory with the installation files for the Guardant key.

cd /var/lib/luna/current/extras/grd/linux

Unpack the archive with the files of the Guardant Control Center service.

tar -xvf grdcontrol-3.29.tar.gz

Launch the Guardant Control Center service.

./grdcontrol-3.29/install.sh

Activate license#

Assign the necessary permissions to the utility.

chmod +x license_wizard

Install a package intended to run front-end applications without physical output to the screen.

yum -y install xorg-x11-server-Xvfb

Execute the license activation command, replacing "your_license_key" with the key received from the VisionLabs representative.

xvfb-run ./license_wizard --console --activate "your_license_key" --host "https://ga.visionlabs.ai:9999/"

The license activation status should be displayed in the logs.

Save license ID#

There are two options for obtaining a license ID:

1) Go to the Guardant user interface http://<your_host_address>:3189/. A new key should appear on the "Dongles" tab. Save this ID, it will be required to fill in the Licenses service settings.

2) Using the terminal, navigate to the directory with the installation files for the Guardant-key:

cd /var/lib/luna/current/extras/grd/linux

Then enter the command to view the list of activated products:

./license_wizard --console --list

According to the results of the command execution, the terminal returns the list of activated products. The top of the list contains the key identifier in the AED9773F format. Save this ID, it will be required to fill in the Licenses service settings.

Specify server address and license key in Licenses settings#

To activate the license, you need to specify the server address and key in the Licenses service settings.

This can be done using the following methods:

Installation manual: In the "platform_settings.json" file before starting the LUNA PLATFORM installation or in the Configurator settings before starting the Licenses container.
Upgrade manual: In the Configurator settings before starting the Licenses container.
Installation using Docker Compose: In the "platform_settings.json" file before running the script.

There is no access to Internet#

You should perform these steps if there is no Internet connection on the server where license activation is required. In this case, it is supposed to use an auxiliary server with access to the Internet.

Sequencing without internet#

The sequence of actions to activate the license:

Request a license key from a VisionLabs representative.
Install and run Guardant Control Center (general server).
Generate a license request file (general server).
Install and run Guardant Control Center (auxiliary server).
Generate a license activation file (auxiliary server).
Activate the license (general server).
Go to the Guardant user interface and save the license ID (auxiliary server).
Specify your server address and license ID. This can be done using the following methods:
- Installation manual: in the "platform_settings.json" file before starting the LUNA PLATFORM installation or in the Configurator settings before starting the Licenses container.
- Upgrade manual: in the Configurator settings before starting the Licenses container.
- Installation using Docker Compose: in the "platform_settings.json" file before running the script.
Relevant documents contain reminders of the above actions.

The "Dongles" tab of the user interface (<server_host_address>:3189) displays activated keys.

Launch Guardant Control Center (general server)#

Note. When updating Guardant Control Center, you must re-issue the license key.

To activate the license, you need to launch the Guardant Control Center security key management service.

Go to the directory with the installation files for the Guardant key.

cd /var/lib/luna/current/extras/grd/linux

Unpack the archive with the files of the Guardant Control Center service.

tar -xvf grdcontrol-3.29.tar.gz

Launch the Guardant Control Center service.

./grdcontrol-3.29/install.sh

Generate license request file (general server)#

Assign the necessary permissions to the utility.

chmod +x license_wizard

Install a package intended to run front-end applications without physical output to the screen.

For Almalinux 8:

dnf install xorg-x11-server-Xvfb-1.20.11-2.el8.x86_64.rpm

You can check the version of Almalinux using the cat /etc/almalinux-release command.

If you are using another operating system, then you need to download the "xorg-x11-server-Xvfb" package from the auxiliary server yourself and transfer it to the general server.

Run the command to create a request file, specifying the path where you want to save the request file "vlabs.request":

xvfb-run ./license_wizard --console --activate-request bin/vlabs.request

Generate license activation file (auxiliary server)#

Transfer the generated request file "vlabs.request" to the auxiliary server.

To generate a license file, you need to run the "license_wizard" utility. The utility can be run on Linux or Windows. The steps described below can be performed both on a Linux server and on a Windows server. Depending on the operating system, go to the linux or windows directory in the following package path: luna_v.5.86.0/extras/grd/

Depending on the OS, follow the appropriate links below:

Generate license activation file on Linux#

The auxiliary server also requires a running Guardant Control Center.

Unpack the archive with the files of the Guardant Control Center service.

tar -xvf grdcontrol-3.29.tar.gz

Launch the Guardant Control Center service.

./grdcontrol-3.29/install.sh

Assign the necessary permissions to the "license_wizard" utility.

chmod +x license_wizard

Install a package intended to run front-end applications without physical output to the screen.

yum -y install xorg-x11-server-Xvfb

Run the license activation command.

xvfb-run ./license_wizard --console --activate-response your_license_key bin/vlabs.request bin/vlabs.license --host "https://ga.visionlabs.ai:9999/"

Here:

your_license_key — Key received from a VisionLabs representative.
bin/vlabs.request — Path where the request file "vlabs.request" is located.
bin/vlabs.license — Path where you need to save the license file "vlabs.license".

Go to the section "Activate license (general server)".

Generate license activation file on Windows#

Perform the installation by running the file "grdcontrol-3.29.msi".

Run the file "license_wizard.exe".

Perform the following actions in the window that appears:

Click the "License Activation" button in the upper right corner.
Click the "Settings" button in the lower left corner and enter the following VisionLabs server address: https://ga.visionlabs.ai:9999/.
Press the "Back" button.
Press the button "On another".
Click the "Continue" button.
Click the "Select a file" button.

Select the file and specify the license key received from the VisionLabs representative.

Click "Activate a new license". The "Save" license button will appear. Save the generated file "vlabs_fingerprint.license".

Go to the section "Activate license (general server)".

Activate license (general server)#

Transfer the generated "vlabs.license" file to the general server.

Execute the license activation command, specifying the path where the license activation file "vlabs.license" is located.

xvfb-run ./license_wizard --console --activate-offline bin/vlabs.license

Save license ID (auxiliary server)#

Go to the Guardant user interface http://<your_host_address>:3189/. A new key should appear on the "Dongles" tab. Save this ID, it will be required to fill in the Licenses service settings.

Set server address and license key in Licenses settings#

To activate the license, you need to specify the server address and key in the Licenses service settings.

This can be done using the following methods:

Installation manual: In the "platform_settings.json" file before starting the LUNA PLATFORM installation or in the Configurator settings before starting the Licenses container.
Upgrade manual: In the Configurator settings before starting the Licenses container.
Installation using Docker Compose: In the "platform_settings.json" file before running the scrip.t