Перейти к содержанию

# Введение

Вы можете активировать лицензию либо с помощью HASP-ключа, либо с помощью Guardant-ключа.

Выберите необходимый способ и перейдите по соответствующей ссылке ниже:

- Активация лицензии с помощью HASP-ключа
- Активация лицензии с помощью Guardant-ключа

# Активация лицензии с помощью HASP-ключа

Примечание. Данный раздел описывает активацию лицензии только с помощью HASP-ключа. Перейдите к разделу "Активация лицензии с помощью Guardant-ключа" для ознакомления с соответствующей инструкцией.

HASP-ключ использует библиотеку "haspvlib_x86_64_30147.so", находящуюся в директории `/var/hasplm/`.

Последовательность действий для настройки лицензии:

1． Установите на сервер утилиту HASP. Обычно утилита HASP устанавливается на отдельный сервер; 1． Запустите утилиту HASP; 1． Создайте отпечаток системы для вашего сервера и отправьте его в VisionLabs; 1． Активируйте свой ключ, полученный от VisionLabs; 1． Укажите адрес вашего сервера. Это можно сделать с помощью следующих способов: * Руководство по установке: в файле "platform_setting.json" перед началом установки FaceStream или в настройках Configurator перед запуском контейнера Licenses * Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses

> Вкладка Sentinel Keys пользовательского интерфейса (`<server_host_address>:1947`) отображает активированные ключи.

## Установка утилиты HASP

LP использует утилиту HASP определённой версии.

> Если на сервере установлена более старая версия утилиты, её следует удалить перед установкой новой версии. См. раздел "Удаление старой утилиты HASP".

Откройте директорию HASP.

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

Установите утилиту HASP на сервер.

    yum -y install /var/lib/fs/fs-current/extras/hasp/aksusbd-*.rpm

Запустите утилиту HASP.

    systemctl daemon-reload

    systemctl start aksusbd

    systemctl enable aksusbd

    systemctl status aksusbd

## Конфигурация утилиты HASP

Осуществить конфигурацию утилиты HASP можно с помощью файла `/etc/hasplm/hasplm.ini`.

> Не выполняйте это действие, если INI файл для утилиты HASP уже сконфигурирован.

Удалите старый файл настроек, если необходимо.

    rm -rf /etc/hasplm/hasplm.ini

Скопируйте INI файл с конфигурациями. Параметры не описаны в данном документе.

    cp /var/lib/fs/fs-current/extras/hasp/hasplm.ini /etc/hasplm/

## Добавление библиотеки вендора

Скопируйте библиотеку вендора (x32 и x64). Она требуется для использования лицензионного ключа LP.

    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/

Перезапустите утилиту

    systemctl restart aksusbd

## Создание отпечатка системы

Откройте директорию HASP.

    cd /var/lib/fs/fs-current/extras/hasp/licenseassist

Запустите скрипт.

    ./LicenseAssist fingerprint > fingerprint_30147.c2v

Отпечаток системы сохраняется в файл "fingerprint_30147.c2v".

Отправьте файл в VisionLabs. Ваш лицензионный ключ будет создан с использованием данного отпечатка.

> При необходимости можно сохранить отпечаток системы из пользовательского интерфейса по адресу `<host_address>:1947`, нажав кнопку "Fingerprint" на вкладке "Sentinel Keys".

## Добавление файла с лицензией вручную с помощью пользовательского интерфейса

- Перейдите: `<host_address>:1947` (если доступ запрещен, проверьте настройки Firewall/SELinux (данная процедура не описана в этом документе));

- Выберите Update/Attach в левой панели;

- Нажмите "Select File..." и выберите файл(ы) лицензии в появившемся окне;

- Нажмите "Apply File".

Добавление файла с лицензией

## Удаление старой утилиты HASP

Примечание. Удаляйте утилиту HASP, только если необходимо установить более новую версию. В противном случае пропустите этот шаг.

Остановите и отключите утилиту.

    systemctl stop aksusbd

    systemctl disable aksusbd

    systemctl daemon-reload

    yum -y remove aksusbd haspd

# Активация лицензии с помощью Guardant-ключа

Примечание. Данный раздел описывает лицензии только с помощью Guardant-ключа. Перейдите к разделу "Активация лицензии с помощью HASP-ключа" для ознакомления с соответствующей инструкцией.

Для активации с помощью Guardant-ключа доступно два варианта — с доступом к сети Интернет на сервере, где планируется активировать лицензию, и без доступа к сети Интернет. Второй способ предполагает использование вспомогательного сервера с доступом к сети Интернет.

Выберите необходимый способ и перейдите по соответствующей ссылке ниже:

- Активация лицензии с доступом к сети Интернет
- Активация лицензии без доступа к сети Интернет

## Есть доступ к сети Интернет

Следует выполнять данные действия, при условии наличия подключения к сети Интернет на сервере, где требуется активация лицензии.

### Последовательность действий с доступом к сети Интернет

Последовательность действий для настройки лицензии:

1． Запросите лицензионный ключ у представителя VisionLabs. 1． Установите и запустите Guardant Control Center. 1． Активируйте лицензию. 1． Перейдите в пользовательский интерфейс Guardant и сохраните идентификатор лицензии. 1． Укажите адрес вашего сервера и идентификатор лицензии. Это можно сделать с помощью следующих способов: * Руководство по установке: в файле "platform_setting.json" перед началом установки FaceStream или в настройках Configurator перед запуском контейнера Licenses * Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses

    Соответствующие документы содержат напоминания о вышеописанных действиях.

> Вкладка "Ключи" пользовательского интерфейса (`<server_host_address>:3189`) отображает активированные ключи.

### Запуск Guardant Control Center

Для активации лицензии требуется запустить сервис управления ключами защиты Guardant Control Center.

Перейдите в директорию с установочными файлами для Guardant-ключа:

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

Распакуйте архив с файлами сервиса Guardant Control Center:

    tar -xvf grdcontrol-3.21.tar.gz

Запустите сервис Guardant Control Center:

    ./grdcontrol-3.21/install.sh

### Активация лицензии

Назначьте необходимые права для утилиты:

    chmod +x license_wizard

Установите пакет, предназначенный для запуска интерфейсных приложений без физического вывода на экран:

    yum -y install xorg-x11-server-Xvfb

Выполните команду активации лицензии, заменив "your_license_key", на ключ, полученный у представителя VisionLabs.

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

В логах должен отобразиться статус активации лицензии.

### Сохранение идентификатора лицензии

Перейдите в пользовательский интерфейс Guardant `http://<your_host_address>:3189/`. На вкладке "Ключи" должен появиться новый ключ. Сохраните этот идентификатор, он потребуется для заполнения настройки Licenses.

Идентификатор лицензии

## Нет доступа к сети Интернет

Следует выполнять данные действия, при условии отсутствия подключения к сети Интернет на сервере, где требуется активация лицензии. В таком случае предполагается использовать вспомогательный сервер с доступом к сети Интернет.

### Последовательность действий без доступа к сети Интернет

Последовательность действий для настройки лицензии:

1． Запросите лицензионный ключ у представителя VisionLabs. 1． Установите и запустите Guardant Control Center (основной сервер). 1． Сгенерируйте файл-запроса (основной сервер).
1． Установите и запустите Guardant Control Center (вспомогательный сервер). 1． Сгенерируйте файл-лицензии (вспомогательный сервер). 1． Активируйте лицензию (основной сервер). 1． Перейдите в пользовательский интерфейс Guardant и сохраните идентификатор лицензии (вспомогательный сервер). 1． Укажите адрес вашего сервера и идентификатор лицензии. Это можно сделать с помощью следующих способов: * Руководство по установке: в файле "platform_setting.json" перед началом установки FaceStream или в настройках Configurator перед запуском контейнера Licenses * Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses

    Соответствующие документы содержат напоминания о вышеописанных действиях.

> Вкладка "Ключи" пользовательского интерфейса (`<server_host_address>:3189`) отображает активированные ключи.

### Запуск Guardant Control Center (основной сервер)

Для активации лицензии требуется запустить сервис управления ключами защиты Guardant Control Center.

Перейдите в директорию с установочными файлами для Guardant-ключа:

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

Распакуйте архив с файлами сервиса Guardant Control Center:

    tar -xvf grdcontrol-3.21.tar.gz

Запустите сервис Guardant Control Center:

    ./grdcontrol-3.21/install.sh

### Генерация файла-запроса (основной сервер)

Назначьте необходимые права для утилиты:

    chmod +x license_wizard

Установите пакет, предназначенный для запуска интерфейсных приложений без физического вывода на экран.

Для CentOS 7:

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

Для CentOS 8:

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

> Проверить версию CentOS можно с помощью команды `cat /etc/centos-release`.

> Если используется другая операционная система, то необходимо самостоятельно скачать пакет "xorg-x11-server-Xvfb" со вспомогательного сервера и перенести его на основной сервер.

Выполните команду для создания файла-запроса, указав путь, куда необходимо сохранить файл-запроса "vlabs.request":

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

### Генерация файла-лицензии (вспомогательный сервер)

Перенесите сгенерированный файл-запроса "vlabs.request" на вспомогательный сервер.

Для генерации файла-лицензии необходимо запустить утилиту "license_wizard". Утилита может быть запущена на Linux или Windows. Нижеописанные действия можно выполнить на обоих операционных системах. В зависимости от операционной системы, перейдите в директорию `linux` или `windows` по следующему пути комплекта поставки: `extras/grd/`.

В зависимости от ОС, перейдите по ссылке ниже:

- Генерация файла-лицензии на Linux
- Генерация файла-лицензии на Windows

#### Linux

Для вспомогательного сервера также требуется запущенный Guardant Control Center.

Распакуйте архив с файлами сервиса Guardant Control Center:

    tar -xvf grdcontrol-3.21.tar.gz

Запустите сервис Guardant Control Center:

    ./grdcontrol-3.21/install.sh

Назначьте необходимые права для утилиты "license_wizard":

    chmod +x license_wizard

Установите пакет, предназначенный для запуска интерфейсных приложений без физического вывода на экран:

    yum -y install xorg-x11-server-Xvfb

Выполните команду активации лицензии:

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

Здесь:

- your_license_key — ключ, полученный у представителя VisionLabs;
- bin/vlabs.request — путь, где расположен файл-запроса "vlabs.request";
- bin/vlabs.license — путь, куда необходимо сохранить файл-лицензии "vlabs.license".

Перейдите к разделу "Активация лицензии (основной сервер)".

#### Windows

Выполните установку, запустив файл "grdcontrol-3.21.msi".

Запустите файл "license_wizard.exe".

Выполните следующие действия в появившемся окне:

- нажмите кнопку "Активация лицензии" в правом верхнем углу

- нажмите кнопку "Настройки" в левом нижнем углу и введите следующий адрес сервера VisionLabs: `http://ga.visionlabs.ai:9999/`

- нажмите кнопку "Назад"

- нажмите кнопку "На другом"

- нажмите кнопку "Продолжить"

- нажмите кнопку "Выбрать файл"

- выберите файл и укажите лицензионный ключ, полученный у представителя VisionLabs.

Окно активации лицензии

- нажмите "Активировать новую лицензию". Появится кнопка сохранения лицензии. Сохраните сгенерированный файл-лицензии "vlabs.license".

Перейдите к разделу "Активация лицензии (основной сервер)".

### Активация лицензии (основной сервер)

Перенесите сгенерированный файл "vlabs.license" на основной сервер.

Выполните команду активации лицензии, указав путь, где расположен файл-лицензии "vlabs.license".

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

### Сохранение идентификатора лицензии (вспомогательный сервер)

Перейдите в пользовательский интерфейс Guardant `http://<your_host_address>:3189/`. На вкладке "Ключи" должен появиться новый ключ. Сохраните этот идентификатор, он потребуется для заполнения настройки Licenses.

Идентификатор лицензии