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

# Введение

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

При необходимости можно изменить вендора с HASP на Guardant и наоборот.

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

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

# Распаковка дистрибутива

Дистрибутив представляет собой архив luna_v.5.139.0, где v.5.139.0 это числовой идентификатор, обозначающий версию LUNA PLATFORM.

Архив включает в себя лицензионные файлы, требуемые для активации лицензии.

Переместите дистрибутив в директорию на вашем сервере перед установкой. Например, переместите файлы в директорию `/root/`. В ней не должно быть никакого другого дистрибутива или файлов лицензии кроме целевых.

Создайте директорию для распаковки файла дистрибутива.

    mkdir -p /var/lib/luna

Переместите дистрибутив в директорию c LUNA PLATFORM.

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

Установите приложение для распаковки архива при необходимости.

    dnf install -y unzip

Откройте папку с дистрибутивом.

    cd /var/lib/luna

Распакуйте файлы.

    unzip luna_v.5.139.0.zip

# Создание символической ссылки

Создайте символическую ссылку.

> Символическая ссылка показывает, что актуальная версия файла дистрибутива используется для запуска LUNA PLATFORM.

    ln -s luna_v.5.139.0 current

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

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

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

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

1． Установите на сервер утилиту HASP. Обычно утилита HASP устанавливается на отдельный сервер;

2． Запустите утилиту HASP;

3． Создайте отпечаток системы для вашего сервера и отправьте его в VisionLabs;

4． Активируйте свой ключ, полученный от VisionLabs;

5． Укажите адрес вашего сервера. Это можно сделать с помощью следующих способов:

- Руководство по установке: в файле "platform_settings.json" перед началом установки LUNA PLATFORM или в настройках Configurator перед запуском контейнера Licenses
- Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses
- Руководство по запуску через Docker Compose: в файле "platform_settings.json" перед началом запуском скрипта

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

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

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

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

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

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

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

    dnf -y install /var/lib/luna/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/luna/current/extras/hasp/hasplm.ini /etc/hasplm/

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

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

    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/

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

    systemctl restart aksusbd

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

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

    cd /var/lib/luna/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

    dnf -y remove aksusbd haspd

### Указание адреса сервера в настройках Licenses

Для активации лицензии нужно указать адрес сервера в настройках сервиса Licenses.

Это можно сделать с помощью следующих способов:

- Руководство по установке: в файле "platform_settings.json" перед началом установки LUNA PLATFORM или в настройках Configurator перед запуском контейнера Licenses
- Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses
- Руководство по запуску через Docker Compose: в файле "platform_settings.json" перед началом запуском скрипта

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

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

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

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

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

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

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

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

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

1． Запросите лицензионный ключ у представителя VisionLabs.

2． Установите и запустите Guardant Control Center.

3． Активируйте лицензию.

4． Перейдите в пользовательский интерфейс Guardant и сохраните идентификатор лицензии.

5． Укажите адрес вашего сервера и идентификатор лицензии. Это можно сделать с помощью следующих способов:

- Руководство по установке: в файле "platform_settings.json" перед началом установки LUNA PLATFORM или в настройках Configurator перед запуском контейнера Licenses
- Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses
- Руководство по запуску через Docker Compose: в файле "platform_settings.json" перед началом запуском скрипта

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

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

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

Примечание. При обновлении Guardant Control Center необходимо заново выписать лицензионный ключ.

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

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

    cd /var/lib/luna/current/extras/grd/linux

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

    tar -xvf grdcontrol-4.4.3.tar.gz

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

    ./grdcontrol-4.4.3/install.sh

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

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

    chmod +x license_wizard

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

    dnf -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/"

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

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

Существует два способа для получения идентификатора лицензии:

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

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

2) Используя терминал перейдите в директорию с установочными файлами для Guardant-ключа:

    cd /var/lib/luna/current/extras/grd/linux

Далее введите команду для просмотра списка активированных продуктов:

    ./license_wizard --console --list

По результатам выполнения команды терминал вернет список активированных продуктов. Вверху списка указан идентификатор ключа в формате `AED9773F`. Сохраните этот идентификатор, он потребуется для заполнения настройки Licenses.

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

### Указание адреса сервера и ключа в настройках Licenses

Для активации лицензии нужно указать адрес сервера и ключ в настройках сервиса Licenses.

Это можно сделать с помощью следующих способов:

- Руководство по установке: в файле "platform_settings.json" перед началом установки LUNA PLATFORM или в настройках Configurator перед запуском контейнера Licenses
- Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses
- Руководство по запуску через Docker Compose: в файле "platform_settings.json" перед началом запуском скрипта

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

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

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

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

1． Запросите лицензионный ключ у представителя VisionLabs.

2． Установите и запустите Guardant Control Center (основной сервер).

3． Сгенерируйте файл-запроса (основной сервер).

4． Установите и запустите Guardant Control Center (вспомогательный сервер).

5． Сгенерируйте файл-лицензии (вспомогательный сервер).

6． Активируйте лицензию (основной сервер).

7． Перейдите в пользовательский интерфейс Guardant и сохраните идентификатор лицензии (вспомогательный сервер).

8． Укажите адрес вашего сервера и идентификатор лицензии. Это можно сделать с помощью следующих способов:

- Руководство по установке: в файле "platform_settings.json" перед началом установки LUNA PLATFORM или в настройках Configurator перед запуском контейнера Licenses
- Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses
- Руководство по запуску через Docker Compose: в файле "platform_settings.json" перед началом запуском скрипта

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

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

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

Примечание. При обновлении Guardant Control Center необходимо заново выписать лицензионный ключ.

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

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

    cd /var/lib/luna/current/extras/grd/linux

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

    tar -xvf grdcontrol-4.4.3.tar.gz

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

    ./grdcontrol-4.4.3/install.sh

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

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

    chmod +x license_wizard

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

Для Almalinux 9.5:

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

> Проверить версию Almalinux 9.5 можно с помощью команды `cat /etc/almalinux-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` по следующему пути комплекта поставки: `luna_v.5.139.0/extras/grd/`.

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

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

#### Linux

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

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

    tar -xvf grdcontrol-4.4.3.tar.gz

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

    ./grdcontrol-4.4.3/install.sh

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

    chmod +x license_wizard

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

    dnf -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-4.4.3.msi".

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

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

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

- нажмите кнопку "Настройки" в левом нижнем углу и введите следующий адрес сервера VisionLabs: `https://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.

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

### Указание адреса сервера и ключа в настройках Licenses

Для активации лицензии нужно указать адрес сервера и ключ в настройках сервиса Licenses.

Это можно сделать с помощью следующих способов:

- Руководство по установке: в файле "platform_settings.json" перед началом установки LUNA PLATFORM или в настройках Configurator перед запуском контейнера Licenses
- Руководство по обновлению: в настройках Configurator перед запуском контейнера Licenses
- Руководство по запуску через Docker Compose: в файле "platform_settings.json" перед началом запуском скрипта

# Обновление лицензионного ключа Guardant

Для обновления лицензии или для перехода с триальной лицензии на коммерческую необходимо запросить новый ключ у представителя VisionLabs и активировать в соответствии с инструкцией по активации.

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

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

# Смена вендора

Для смены вендора с HASP на Guardant и наоборот необходимо выполнить следующие действия:

- выполнить действия по активации лицензии с помощью HASP-ключа или с помощью Guardant-ключа
- перейти в интерфейс сервиса Configurator `http://<configurator_server_ip>:5070/`
- ввести в поле "Setting name" значение "LICENSE_VENDOR" и нажать "Apply Filters"
- смена вендора с HASP на Guardant
  - задать "guardant" в поле "vendor"
  - задать IP-адрес сервера с вашим ключом Guardant в поле "server_address" в формате "127.0.0.1"
  - добавить поле "license_id" и задать в нем идентификатор лицензии в формате `0x<your_license_id>`
- смена вендора с Guardant на HASP
  - задать "hasp" в поле "vendor"
  - удалить поле "license_id"
  - задать IP-адрес сервера с вашим ключом HASP в поле "server_address" в формате "127.0.0.1"
- нажать "Save"