Установка#

LUNA KIOSK поставляется в двух конфигурациях, отличающихся способом хранения настроек:

На Ubuntu 24.04 x64, Debian 10 x64 и Armbian 23: Используются файлы конфигурации server.conf и rsengine.conf, расположенные в папке /client.
server.conf - содержит настройки работы сервера и логирования.
rsengine.conf - определяет пороговые значения для проверок Liveness.
На Windows: Настройки для RSE Server и библиотеки RSEngine по умолчанию сохраняются в реестре Windows после установки.

Примечание: По умолчанию файлы конфигурации в поставке под ОС Windows в папке /client отсутствуют, так как рекомендуется использование конфигурации на основе реестра. Запросите файлы конфигурации в VisionLabs, если вы используете их в качестве способа настройки.

Установка на Windows#

RSE Server устанавливается как сервис Windows.

Шаг 1: Активация лицензии#

Перед установкой настройте лицензию, отредактировав файл data/license.conf значениями, указанными в вашем лицензионном письме от VisionLabs.

В таблице ниже описаны параметры, необходимые для активации лицензии:

Параметр	Описание	Пример
`Server`	URL сервера активации, используемого для проверки и активации лицензии.	https://
`EID`	Идентификатор права доступа.	00000000-0000-0000-0000-0000-0000-000000000000
`ProductID`	Идентификатор продукта.	00000000-0000-0000-0000-0000-0000-000000000000
`LICENSE_FILENAME`	Имя файла лицензии. Непубличный параметр, не изменяйте.	license.dat
`LICENSE_CONTAINERMODE`	Режим запуска лицензии: `0` - запуск в контейнере `1` - локально (рекомендуется)	`1`

Шаг 2: Подготовка к установке LUNA KIOSK#

1․ Запустите InstallService.bat от имени администратора из корневой директории дистрибутивного пакета.

При запуске скрипт выполняет следующую последовательность действий:

проверка прав администратора;
создание и обновление службы RSEngine Server (RSE-server.exe svc);
установка зависимости (VC++ Redistributable), если файл установщика находится в том же каталоге;
создание папки для хранения логов;
запись настроек в реестр по пути HKLM\Software\VisionLabs\RSEServer;
запуск службы RSEngine Server.

2․ Во время установки:

Сервис регистрируется в реестре Windows.
Директория для логов создаётся по умолчанию в C:\RSE\logs.
Уровни логирования можно изменить позже в реестре Windows.

Шаг 3: Конфигурирование системы#

Все параметры системы записываются в реестр Windows. Параметрам присваиваются значения по умолчанию, которые могут быть изменены администратором. Полный список параметров см. в Приложении 1.

Шаг 4: Управление системой#

После завершения установки можно управлять RSE Sever с помощью менеджера служб services.msc.

Важно: Не меняйте расположение RSE Server и файлов *.conf после установки. В противном случае работоспособность системы будет нарушена.

Отложенный запуск сервиса#

При установке LUNA KIOSK вы можете управлять запуском сервиса сразу после установки.

Для этого используйте параметр StartService скрипта установки installService.bat. Параметр имеет следующие значения:

Значение	Описание
`true`	По умолчанию. Сервис будет запущен автоматически после установки.
`false`	Сервис будет установлен, но его запуск будет пропущен.

Устранение проблем с выборкой метаданных для сенсоров камеры RealSense#

ОС Windows требует наличия специальной записи в реестре для каждого уникального видеоустройства, чтобы предоставлять метаданные. Метаданные, или атрибуты метаданных, относятся к дополнительной информации, предоставляемой библиотекой librealsense, и необходимы для правильного взаимодействия с сенсорами камеры RealSense.

Для активации функционала, связанного с атрибутами метаданных, в комплект поставки LUNA KIOSK включён файл realsense_metadata_win10.ps1. Скрипт в файле создает и изменяет записи в реестре Windows для обеспечения корректной работы сенсоров камеры RealSense. Более подробная информация по активации метаданных представлена в документации библиотеки librealsense.

Установка на ОС Ubuntu 24.04 x64, Debian 10 x64 и Armbian 23#

Предварительные требования#

Используйте Ansible для автоматизации установки на системах на базе Linux:

1․ Установите Ansible:

apt-get install ansible

2․ Проверьте установку:

ansible --version

Если установка прошла успешно, в консоли будет отображена версия Ansible и друга информация:

  ansible [core 2.12.4]
    config file = /etc/ansible/ansible.cfg
    configured module search path = ['/home/vivek/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
    ansible python module location = /usr/lib/python3/dist-packages/ansible
    ansible collection location = /home/vivek/.ansible/collections:/usr/share/ansible/collections
    executable location = /usr/bin/ansible
    python version = 3.8.10 (default, Mar 15 2022, 12:22:08) [GCC 9.4.0]
    jinja version = 2.10.1
    libyaml = True

Шаг 1: Предварительные действия и активация лицензии#

Перед запуском установки:

1․ Добавьте адреса (ip or hostname) целевых устройств в файл ansible/hosts для установки дистрибутива. Каждая строка содержит один адрес. Например:

[rse]
12.16.58.33

2․ Настройте общие переменные и данные лицензии в файле group_vars/all.yml:

Note: LICENSE_SERVER, LICENSE_EID, LICENSE_PRODUCTID are responsible for licensing and provided by VisionLabs.

Переменная	Описание	Возможные значения
`RSE_HOME`	Директория установки. Непубличное значение, не изменяйте.	/var/lib/kiosk
`RSE_VERSION`	Версия системы. Значение должно совпадать с именем архива.	ub1804_x64_v1.0.4_rc2
`RSE_ZIP_LOCATION`	Абсолютный или относительный путь к дистрибутиву RSE Server внутри пакета дистрибутива.	../distr/rse-server_v.2.5.0.zip
`LICENSE_SERVER`	Адрес сервера лицензий. Запросите данные в VisionLabs.	https://.com
`LICENSE_EID`	Идентификатор права доступа. Запросите данные в VisionLabs.	00000000-0000-0000-0000-0000-000000000000
`LICENSE_PRODUCTID`	Идентификатор продукта. Запросите данные в VisionLabs.	00000000-0000-0000-0000-0000-0000-000000000000
`LICENSE_FILENAME`	Имя файла лицензии. Непубличный параметр, не изменяйте.	license.dat
`LICENSE_CONTAINERMODE`	Режим запуска лицензии.	`0` - запуск в контейнере `1` - локальный (рекомендуется)
`licenseModel`	Используемая лицензия. Запросите данные в VisionLabs.	`1` - Система использует лицензию FIT. `2` - Система использует лицензию Zeus.

Шаг 2: Установка LUNA KIOSK#

Место установки системы указывается в переменной RSE_HOME.

Перейдите в папку ansible и выполните:

Для удаленных хостов:

Если установка выполняется на нескольких устройствах одновременно (в файле hosts указано более одного IP-адреса), выполните команду:

ansible-playbook -I hosts install_rse.yml

Во время установки Ansible пытается подключиться как системный пользователь (по умолчанию root) с помощью соответствующей пары SHH-ключей. Если вместо ключей используется пароль, добавьте флаг --ask-pass в команду установки.

Для локальной установки:

Если установка выполняется локально на одном устройстве, выполните команду:

ansible-playbook -i hosts--connection=local--inventory 127.0.0.1, install_rse.yml

Шаг 3: Настройка LUNA KIOSK#

При запуске RSE Server, LUNA KIOSK использует настройки из файлов конфигурации server.conf и rsengine.conf. Описание параметров см. в Приложении 1.

Если вам нужно изменить настройки конфигурации клиента, внесите изменения в файлы server.conf и rsengine.conf и перезапустите RSE Server.

Если установка прошла успешно, логи будут записываться в файлы журналов в директории по умолчанию ./logs после запуска LUNA KIOSK. Чтобы изменить местоположение, обновите параметр log-path в файле server.conf.

Шаг 4: Управление LUNA KIOSK в Linux#

После завершения установки можно управлять RSE Sever с помощью утилиты командной строки systemctl.

Для запуска RSE Sever необходимо запустить следующую команду:

systemctl start kiosk

Для остановки RSE Sever необходимо запустить следующую команду:

systemctl stop kiosk

Активация лицензии в офлайн-режиме#

Используйте оффлайн-активацию, когда целевое устройство не имеет доступа к интернету. В этом сценарии:

отпечаток устройства генерируется на оффлайн-устройстве;
лицензия активируется на устройстве с доступом в интернет с использованием этого отпечатка.

Предварительные требования#

Перед началом получите адрес сервера лицензий и EID у VisionLabs

Шаг 1: Генерация отпечатка устройства#

На оффлайн-устройстве, где будет установлена лицензия:

1․ Откройте файл license.conf, расположенный в директории data. 2․ Укажите EID и сохраните файл. 3․ Запустите утилиту FingerprintViewer для генерации отпечатка:
- На Linux/Armbian:
1․ Перейдите в папку extras.

2․ Предоставьте права доступа утилите FingerprintViewer:

  ```bash
    chmod +x FingerprintViewer
  ```

3․ Запустите утилиту, указав путь к файлу *license.conf*:

  ```bash
  ./FingerprintViewer ../data/license.conf
  ```

На Windows:

Запустите FingerprintViewer.exe из корневой папки дистрибутивного пакета.

4․ Скопируйте отображённый в консоли отпечаток для использования на следующем шаге.

Шаг 2: Активация лицензии#

На устройстве с доступом в интернет:

Перейдите на портал активации лицензий (URL, полученный от VisionLabs).
Войдите в систему, используя свой EID.
Вставьте скопированный отпечаток устройства для активации лицензии.
Скачайте сгенерированный лицензионный сертификат (licenseFile.v2c).
Переместите licenseFile.v2c в папку data.
Переименуйте файл одним из следующих способов:
Измените параметр Filename в файле license.conf в соответствии с примером:
```
<param name="Filename" type="Value::String" text="licenseFile.v2c"/>
```
Переименуйте licenseFile.v2c в license.dat и убедитесь, что параметр Filename в файле license.conf соответствует фактическому имени:
```
<param name="Filename" type="Value::String" text="license.dat"/>
```

Шаг 3: Развертывание лицензии#

Скопируйте полученный лицензионный ключ license.dat в каталог data.