Обновление пакета видеоаналитики с версии 23.12¶

Чтобы обновить видеоаналитику с версии до 23.12 на актуальный релиз, вам необходимо будет выполнить специальную процедуру перехода. Эта процедура отличается от обычного обновления, потому что модуль был значительно переработан.

Требования к системе для старого и нового модуля одинаковы. Поскольку модуль аналитики требует много вычислительных ресурсов, мы настоятельно рекомендуем использовать его с видеокартами NVIDIA.

Обновите драйвера NVIDIA GPU¶

Вся процедура обновления драйверов займет от 5 до 10 минут. В это время видеоаналитика работать не будет.

Если возникнут конфликты пакетов или вы будете устанавливать драйверы не так, как описано ниже (не из официального репозитория NVIDIA или Ubuntu), время простоя может возрасти.

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

apt update
apt install --no-install-recommends nvidia-driver-525

После завершения установки перезагрузите сервер.

Установите переходный пакет с видеоаналитикой¶

На обновляемом сервере видеоаналитики понадобится установить пакет flussonic-vision. Для этого выполните команды:

apt update
apt install flussonic-vision

Во время установки пакета flussonic-vision выполнится автоматическая конфигурация модуля на основании существующей конфигурации пакета flussonic-vision. Будут установлены сервисы Inference и Identification. Сервис Inference нужен для "снятия образов" с потока, а Identification для их идентификации.

Сервисы модуля видеоаналитики должны быть добавлены в Watcher в качестве стримеров с ролями inference и identification, даже если они будут расположены на одном сервере.
После установки пакетов перейдите в интерфейс Watcher и настройте новую систему аналитики, как описано далее.

Настройте компоненты видеоаналитики в Watcher¶

Добавьте стример с ролью Inference¶

Сервис Inference отвечает за детекцию лиц и снятие с них биометрических "отпечатков". Это ресурсоемкая операция, поэтому сервис Inference рекомендуется запускать на сервере с мощной видеокартой.

Чтобы добавить стример с ролью Inference:

1. В интерфейсе Watcher откройте раздел Стримеры.
2. Найдите в списке обновляемый стример.
3. В форме редактирования этого стримера запомните или скопируйте значения в полях API URL и Cluster key.
4. Вернитесь на страницу списка стримеров и нажмите +, чтобы добавить стример.
5. В форме укажите имя сервера. Можно указать реальный хостнейм, а можно произвольную строку. Укажите inference1, это подойдет для первой установки.
6. Выберите роль Inference. Сохраните.
7. Перейдите на страницу с настройками нового стримера и укажите API_URL сервера: http://CLUSTER_KEY@HOSTNAME:9030. Вместо CLUSTER_KEY и HOSTNAME подставьте значения Cluster key и API URL, запомненные на третьем шаге. Сохраните изменения.

8. В файле /etc/vision/vision-inference.conf укажите CONFIG_EXTERNAL=http://CENTRAL_KEY@watcher.lab/central/api/v3/streamers/inference1/streams, здесь:

   • CENTRAL_KEY — API-ключ, который находится в файле /etc/central/central.conf.
   • watcher.lab — реальный адрес вашего сервера с Watcher.

Добавьте стример с ролью Identification¶

Сервис Identification получает отпечатки из Inference и сравнивает их со своей базой данных, чтобы идентифицировать обнаруженное лицо. Процесс идентификации не так требователен к ресурсам.

Обратите внимание, что имя сервера уникальное. Если вы установили два компонента, то в Watcher это будет выглядеть как отдельные стримеры.

Чтобы добавить стример с ролью Identification:

1. В интерфейсе Watcher откройте раздел Стримеры.
2. Нажмите +, чтобы добавить стример.
3. В форме укажите имя сервера. Можно указать реальный хостнейм, а можно произвольную строку. Укажите identification1, это подойдет для первой установки.
4. Выберите роль Identification. Сохраните.
5. Перейдите на страницу с настройками нового стримера и укажите API_URL сервера: http://CLUSTER_KEY@HOSTNAME:9050. Вместо CLUSTER_KEY и HOSTNAME подставьте значения, запомненные при добавлении стримера Inference. Сохраните изменения.

6. В файле /etc/vision/vision-identification.conf укажите CENTRAL_URL=http://CENTRAL_KEY@watcher.lab/central/api/v3, здесь:

   • CENTRAL_KEY — API-ключ, который находится в файле /etc/central/central.conf.
   • watcher.lab — реальный адрес вашего сервера с Watcher.

Запустите и проверьте¶

Отключите модуль аналитики прошлых версий¶

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

1. На обновляемом сервере видеоаналитики в конфигурационном файле /etc/flussonic/flussonic.conf удалите секцию vision.
2. Перегрузите конфигурацию, чтобы изменения применились:

service flussonic reload

Запустите компоненты модуля аналитики¶

После этого можно запустить оба компонента обновленного модуля:

service vision-inference start
service vision-identification start

Если все работает правильно, то через несколько секунд в интерфейсе Watcher индикаторы состояния на странице Стримеры у добавленных стримеров с ролями inference и identification станут зеленого цвета.

Последующие обновления¶

Описанную на этой странице инструкцию нужно выполнить один раз на каждом из ваших серверов с аналитикой. В результате у вас может оказаться запущено несколько сервисов Inference и Identification в кластере. В дальнейшем мы рекомендуем выделить для Identification отдельный сервер для оптимизации использования ресурсов, поскольку Identification гораздо менее требовательна к ресурсам, чем Inference.

Для последующих обновлений:

• Если сервер выполняет обе роли аналитики, в дальнейшем можно обновлять на нем пакет flussonic-vision.
• Если вы вынесете сервис Identification на отдельный сервер, то на серверах можно будет независимо обновлять пакеты vision-identification и vision-inference согласно роли сервера.