Skip to content

# Introduction

You can activate the license either with a HASP key or with a Guardant key.

If necessary, you can change the vendor from HASP to Guardant and vice versa.

Unpack distribution and then select the desired method and follow the appropriate link below:

- License activation using HASP key.
- License activation using Guardant key.
- Vendor change.

# Distribution unpacking

The distribution package is an archive luna_v.5.126.0, where v.5.126.0 is a numerical identifier, describing the current LUNA PLATFORM version.

The archive includes license files, required for license activation.

Move the distribution package to the directory on your server before the installation. For example, move the files to `/root/` directory. The directory should not contain any other distribution or license files except the target ones.

Create directory for distribution file unpacking.

    mkdir -p /var/lib/luna

Move the distribution to the created directory.

    mv /root/luna_v.5.126.0.zip /var/lib/luna

Install the unzip archiver if it is necessary.

    dnf install -y unzip

Go to the folder with distribution.

    cd /var/lib/luna

Unzip files.

    unzip luna_v.5.126.0.zip

# Symbolic link creation

Create a symbolic link.

> The link indicates that the current version of the distribution file is used to run LUNA PLATFORM.

    ln -s luna_v.5.126.0 current

# License activation using HASP key

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

HASP key uses the "haspvlib_x86_64_30147.so" vendor library, which located in the in the `/var/hasplm/` directory.

Follow these steps to set up the license:

1․ Install HASP utility on your server. HASP utility is usually installed on a separate server.

2․ Start the HASP utility.

3․ Create the fingerprint of your server and send it to VisionLabs.

4․ Activate your key, received from VisionLabs.

5․ Specify your server address. 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 Sentinel Keys tab of the user interface (`<server_host_address>:1947`) shows activated keys.

## Install HASP utility

LP uses HASP utility of a certain version.

> If an older version of HASP utility is installed, it is required to delete it before installation of a new version. See Delete old LP hasp utility.

Go to the HASP directory.

    cd /var/lib/luna/current/extras/hasp/

Install HASP utility on you server.

    dnf -y install /var/lib/luna/current/extras/hasp/aksusbd-*.rpm

Launch HASP utility.

    systemctl daemon-reload

    systemctl start aksusbd

    systemctl enable aksusbd

    systemctl status aksusbd

## Configure HASP utility

You can configure the HASP utility using the `/etc/hasplm/hasplm.ini` file.

> You do not need to perform this action if you already have the configured INI file for the HASP utility.

Delete the old file if necessary.

    rm -rf /etc/hasplm/hasplm.ini

Copy the INI file with configurations. Its parameters are not described in this document.

    cp /var/lib/luna/current/extras/hasp/hasplm.ini /etc/hasplm/

## Add vendor library

Copy LP vendor library (x32 and x64). This library is required for using LP license key.

    cp /var/lib/luna/current/extras/hasp/haspvlib_30147.so /var/hasplm/

    cp /var/lib/luna/current/extras/hasp/haspvlib_x86_64_30147.so /var/hasplm/

Restart the utility.

    systemctl restart aksusbd

## Create fingerprint

Go to the HASP directory.

    cd /var/lib/luna/current/extras/hasp/licenseassist

Run the script.

    ./LicenseAssist fingerprint > fingerprint_30147.c2v

The fingerprint is saved to file "fingerprint_30147.c2v".

Send the file to VisionLabs. You license key will be created using this fingerprint.

> You can also save the system fingerprint from the user interface at `<host_address>:1947` by clicking the "Fingerprint" button on the "Sentinel Keys" tab.

## Add license file manually using user interface

- Go to: `<host_address>:1947` (if access is denied check your Firewall/ SELinux settings (the procedure is not described in this document)).

- Select the Update/Attach at the left pane.

- Press the "Select File..." button and select a license file(s) in the appeared window.

- Press the "Apply File" button.

Adding a license file

#### Delete LP old hasp utility

Note: Delete the HASP utility only if you need to install a newer version. Otherwise, skip this step.

Stop and disable the utility.

    systemctl stop aksusbd

    systemctl disable aksusbd

    systemctl daemon-reload

    dnf -y remove aksusbd haspd

### Set server address 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.

# 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:

- License activation with access to the Internet.
- License activation without access to the Internet.

## 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:

1․ Request a license key from a VisionLabs representative.

2․ Install and run Guardant Control Center.

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

4․ Activate the license.

5․ Go to the Guardant user interface and save the license ID.

6․ 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.

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

License ID in the Guardant website

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.
License ID in the terminal

### 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:

1․ Request a license key from a VisionLabs representative.

2․ Install and run Guardant Control Center (general server).

3․ Generate a license request file (general server).

4․ Install and run Guardant Control Center (auxiliary server).

5․ Generate a license activation file (auxiliary server).

6․ Activate the license (general server).

7․ Go to the Guardant user interface and save the license ID (auxiliary server).

8․ 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 9.5:

    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.126.0/extras/grd/`

Depending on the OS, follow the appropriate links below:

- Generate license activation file on Linux
- Generate license activation file on Windows

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

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

License activation window

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

License ID

### 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

# Guardant license key updating

To update the license or to switch from a trial license to a commercial one, you must request a new key from a VisionLabs representative and activate it in accordance with the activation instructions.

Select the desired method and follow the appropriate link below:

- License activation with access to the Internet.
- License activation without access to the Internet.

# Vendor change

To change the vendor from HASP to Guardant and vice versa, you need to perform the following actions:

- Perform license activation actions using the HASP key or using the Guardant key.
- Go to the Configurator service interface `http://<configurator_server_ip>:5070/`.
- Enter the value "LICENSE_VENDOR" in the "Setting name" field and click "Apply Filters".
- Vendor change from HASP to Guardant:
  - Set "guardant" in the "vendor" field.
  - Set the IP address of the server with your Guardant key in the "server_address" field in the format "127.0.0.1".
  - Add the "license_id" field and set the license ID in it in the format `0x<your_license_id>`.
- Vendor change from Guardant to HASP:
  - Set "hasp" in the "vendor" field.
  - Delete the "license_id" field.
  - Set the IP address of the server with your HASP key in the "server_address" field in the format "127.0.0.1".
- Click "Save".