Content

License activation manual

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

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

Adding a license file
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 access to the system graphical interface and the Internet and without it. The second method involves the use of an auxiliary server that meets the requirements described above.

Select the desired method and follow the appropriate link below:

There is access to system graphical interface and Internet

Sequencing

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. Activate the license.
  4. Go to the Guardant user interface and save the license ID.
  5. Specify your server address and license ID. This can be done using the following methods: 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.15.tar.gz

Go to the directory with the unpacked files:

cd grdcontrol-3.15

Launch the Guardant Control Center service:

./install.sh

Launch license_wizard utility

Assign the necessary permissions to the “license_wizard” utility:

chmod +x license_wizard

Run the utility:

./license_wizard 

Activate license

To activate a license, do the following in the window that appears:

License activation window
License activation window

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
License ID

There is no access to system graphical interface and Internet

Sequencing

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. Enter the license key into the Guardant configuration file (general server).
  4. Create a system fingerprint (general server).
  5. Install and run Guardant Control Center (auxiliary server).
  6. Generate a license activation file (auxiliary server).
  7. Activate the license (general server).
  8. Go to the Guardant user interface and save the license ID (auxiliary server).
  9. Specify your server address and license ID. This can be done using the following methods: 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.15.tar.gz

Go to the directory with the unpacked files:

cd grdcontrol-3.15

Launch the Guardant Control Center service:

./install.sh

Create fingerprint (general server)

Go to the directory with the executable file “GrdLicenseAssist”:

cd /var/lib/fs/fs-current/extras/grd/linux/bin

Assign the necessary permissions to the executable file:

chmod +x GrdLicenseAssist

Run the command to create a fingerprint:

./GrdLicenseAssist request vlabs_fingerprint.request 

Save the “vlabs_fingerprint.request” file.

Complete configuration file (general server)

Go to the directory with the Guardant configuration file:

cd /var/lib/fs/fs-current/extras/grd/

Open the configuration file:

vi GrdActivationConfig.json

Specify the key received from the VisionLabs representative in the “SerialNumber” field:

{
    "ActivationInfo": {
      "serialNumber": "<your_serial_number>",
      "host": "ga.visionlabs.ai:9999",
      "port": 443,
      "customerInfo": {
        "firstName": "First name",
        "lastName": "Last name",
        "email": "Email",
        "companyName": "Company name",
        "phone": "Phone"
      }
    }
  }

Save the file.

Launch license_wizard utility (auxiliary server)

To generate a license file, you need to run the “license_wizard” utility. The utility requires a graphical system interface and can be run on either Linux or Windows OS. Transfer the generated file vlabs_fingerprint.request to the auxiliary server.

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: facestream_docker_v.5.1.27/extras/grd/

Depending on the OS, follow the appropriate links below:

Launch license_wizard utility 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.15.tar.gz

Go to the directory with the unpacked files:

cd grdcontrol-3.15

Launch the Guardant Control Center service:

./install.sh

Assign the necessary permissions to the “license_wizard” utility:

chmod +x license_wizard

Run the utility:

./license_wizard 

Go to the section “Activate license (auxiliary server)”.

Launch license_wizard utility on Windows

Perform the installation by running the file “grdcontrol-3.15.msi”.

Run the file “license_wizard.exe”.

Go to the section “Activate license (auxiliary server)”.

Generate license file (auxiliary server)

To activate a license, do the following in the window that appears:

Select the file and specify the key that was specified in the “SerialNumber” field of the “GrdActivationConfig.json” file (see the section “Create fingerprint”).

License activation window
License activation window

Activate license (general server)

The following steps must be performed on the server where you want to activate the license. If the auxiliary server was used, then transfer the file “vlabs_fingerprint.license” to the general server.

Place the license file in the following directory:

/var/lib/fs/fs-current/extras/grd/linux/bin

Activate the license using the “vlabs_fingerprint.license” file:

./GrdLicenseAssist offline vlabs_fingerprint.license ../../GrdActivationConfig.json 

Restart the Guardant Control Center service:

systemctl restart grdcontrol.service

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
License ID