Skip to content

# Introduction

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

Select the desired method and follow the appropriate link below:

- License activation using HASP key
- License activation using Guardant key

# 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. 1․ Start the HASP utility. 1․ Create the fingerprint of your server and send it to VisionLabs. 1․ Activate your key, received from VisionLabs. 1․ Specify your server address. This can be done using the following methods: * Installation manual: in the "platform_setting.json" file before starting the FaceStream installation or in the Configurator settings before starting the Licenses container. * Upgrade manual: in the Configurator settings before starting the Licenses container.

     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/fs/fs-current/extras/hasp/

Install HASP utility on you server.

    yum -y install /var/lib/fs/fs-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/fs/fs-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/fs/fs-current/extras/hasp/haspvlib_30147.so /var/hasplm/

    cp /var/lib/fs/fs-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/fs/fs-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

    yum -y remove aksusbd haspd

# 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. 1․ Install and run Guardant Control Center. 1․ Install a package intended to run front-end applications without physical output to the screen. 1․ Activate the license. 1․ Go to the Guardant user interface and save the license ID. 1․ Specify your server address and license ID. This can be done using the following methods: * Installation manual: in the "platform_setting.json" file before starting the FaceStream installation or in the Configurator settings before starting the Licenses container. * Upgrade manual: in the Configurator settings before starting the Licenses container.

     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

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/fs/fs-current/extras/grd/linux

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

    tar -xvf grdcontrol-3.21.tar.gz

Launch the Guardant Control Center service:

    ./grdcontrol-3.21/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

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

## 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. 1․ Install and run Guardant Control Center (general server). 1․ Generate a license request file (general server). 1․ Install and run Guardant Control Center (auxiliary server). 1․ Generate a license activation file (auxiliary server). 1․ Activate the license (general server). 1․ Go to the Guardant user interface and save the license ID (auxiliary server). 1․ Specify your server address and license ID. This can be done using the following methods: 1․ Specify your server address and license ID. This can be done using the following methods: * Installation manual: in the "platform_setting.json" file before starting the FaceStream installation or in the Configurator settings before starting the Licenses container. * Upgrade manual: in the Configurator settings before starting the Licenses container.

     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)

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/fs/fs-current/extras/grd/linux

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

    tar -xvf grdcontrol-3.21.tar.gz

Launch the Guardant Control Center service:

    ./grdcontrol-3.21/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 CentOS 7:

    yum install xorg-x11-server-Xvfb-1.20.4-10.el7.x86_64.rpm

For CentOS 8:

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

> You can check the version of CentOS using the `cat /etc/centos-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: `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.21.tar.gz

Launch the Guardant Control Center service:

    ./grdcontrol-3.21/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.21.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