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:
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:
The Sentinel Keys tab of the user interface (
<server_host_address>:1947
) shows activated keys.
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
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/
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
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.
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.
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
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:
The sequence of actions to activate the license:
The “Dongles” tab of the user interface (
<server_host_address>:3189
) displays activated keys.
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
Assign the necessary permissions to the “license_wizard” utility:
chmod +x license_wizard
Run the utility:
./license_wizard
To activate a license, do the following 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: http://ga.visionlabs.ai:9999/
press the “Back” button
press the button “On this”
specify the key received from the VisionLabs representative.
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.
The sequence of actions to activate the license:
The “Dongles” tab of the user interface (
<server_host_address>:3189
) displays activated keys.
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
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.
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.
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:
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)”.
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)”.
To activate a license, do the following 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: http://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 key that was specified in the “SerialNumber” field of the “GrdActivationConfig.json” file (see the section “Create fingerprint”).
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
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.