Развертывание из консольного инсталлятора

Для развертывания FindFace Multi используется консольный инсталлятор.

Совет

Перед тем как приступить к развертыванию, обязательно ознакомьтесь с системными требованиями.

Важно

Если вы намерены использовать дополнительный функционал Видеомагнитофон и находитесь на территории России или Беларуси, то перед тем, как приступить к развертыванию, необходимо обратиться в support@ntechlab.com для получения дистрибутива MongoDB. Далее следуйте инструкциям по установке в разделе Устранение неполадок с дистрибутивом MongoDB.

Важно

Для успешного функционирования системы после установки из инсталлятора IP-адрес сервера должен быть статическим. Для того чтобы сделать IP-адрес статическим, откройте файл /etc/network/interfaces и измените текущую запись для основного сетевого интерфейса так, как показано в примере ниже. Не забудьте заменить адреса в примере на актуальные с учетом настроек сети.

sudo vi /etc/network/interfaces

iface eth0 inet static
address 192.168.112.144
netmask 255.255.255.0
gateway 192.168.112.254
dns-nameservers 192.168.112.254

Перезапустите сетевые интерфейсы.

sudo service networking restart

С осторожностью редактируйте файл etc/network/interfaces. Перед тем как приступить к редактированию, ознакомьтесь c инструкцией по настройке сетей Ubuntu.

Для развертывания FindFace Multi из инсталлятора выполните следующие действия:

  1. Загрузите файл инсталлятора findface-multi-1.2-and-server-5.2.run.

  2. Поместите файл .run в любой каталог на сервере установки (например, /home/username).

  3. Из данного каталога сделайте файл .run исполняемым.

    chmod +x findface-multi-1.2-and-server-5.2.run
    
  4. Запустите файл .run.

    sudo ./findface-multi-1.2-and-server-5.2.run
    

    Инсталлятор задаст вам несколько вопросов, после чего проверит, соответствует ли сервер системным требованиям. Ответьте на вопросы надлежащим образом. Вопросы и ответы следующие:

    1. Устанавливаемый продукт: FindFace Multi.

    2. Тип установки:

      Примечание

      Если вы выбрали тип установки №3 или №4, не забудьте установить необходимые модели нейронных сетей вместе с компонентом findface-extraction-api.

    3. Тип пакета findface-video-worker: CPU или GPU.

    4. Тип пакета findface-extraction-api: CPU или GPU.

    5. Do you want to install NtechLab VMS?: yes (да) или no (нет), чтобы установить Видеомагнитофон.

    При выборе установки одиночного сервера FindFace Multi, его компоненты будут автоматически установлены, настроены и запущены в соответствии со следующей конфигурацией:

    Важно

    В случае чистой установки инсталлятор автоматически настроит findface-extraction-api на использование нейронной сети kiwi_320. В противном случае вам будет предложено сделать выбор между kiwi_320 и предыдущей моделью. Категорически не рекомендуется использовать инсталлятор для обновления системы. См. инструкции по обновлению в разделе Обновление до FindFace Multi 1.2.

    Сервис

    Конфигурация

    postgresql-10

    Устанавливается и запускается.

    nats-server

    Устанавливается и запускается.

    etcd

    Устанавливается и запускается.

    pgbouncer

    Устанавливается и запускается.

    memcached

    Устанавливается и запускается.

    nginx

    Устанавливается и запускается.

    django

    Устанавливается и запускается как веб-фреймворк для веб-интерфейса FindFace Multi.

    findface-ntls

    Устанавливается и запускается.

    findface-tarantool-server

    Устанавливается и запускается. Количество экземпляров (шардов) рассчитывается по формуле: N = min(max(min(mem_mb // 2000, cpu_cores), 1), 16 * cpu_cores). Т. е. количество равно размеру оперативной памяти в Мб, разделенному на 2000, или количеству физических ядер процессора (но не менее 1 шарда), или же количеству физических ядер процессора, умноженному на 16, если первое полученное значение больше.

    findface-extraction-api

    Устанавливается и запускается (CPU/GPU-ускорение).

    findface-sf-api

    Устанавливается и запускается.

    findface-upload

    Устанавливается.

    findface-video-manager

    Устанавливается и запускается.

    findface-video-worker-*

    Устанавливается и запускается (CPU/GPU-ускорение).

    findface-data-*

    Модели нейронных сетей для распознавания объектов и их атрибутов. Устанавливаются.

    findface-security

    Устанавливается и запускается.

    findface-counter

    Устанавливается и запускается.

    findface-liveness-api

    Устанавливается и запускается.

    jq

    Устанавливается. Используется для структурирования API-ответов от FindFace Multi в формате JSON.

    python3-ntech.*

    Внутренние и вспомогательные сервисы. Устанавливаются и запускаются.

    findface-video-storage

    Устанавливается и запускается (только вместе с Видеомагнитофоном).

    findface-video-streamer-cpu

    Устанавливается и запускается (только вместе с Видеомагнитофоном).

    mongod

    Устанавливается и запускается (только вместе с Видеомагнитофоном).

    По завершении установки в консоль будет выведена информация, необходимая для использования FindFace Multi:

    Совет

    Обязательно сохраните эти данные: они вам понадобятся.

    #############################################################################
    #                       Installation is complete                            #
    #############################################################################
    - upload your license to http://172.20.77.17/#/license/
    - user interface: http://172.20.77.17/
      superuser:      admin
      password:       admin
      documentation:  http://172.20.77.17/doc/
    
  5. Укажите свою временную зону в файле конфигурации /etc/findface-security/config.py в формате Регион/Страна/Город или Etc/GMT+H. Временная зона определяет время в отчетах, логах, именах артефактов FindFace Multi, таких как полные кадры и миниатюры событий, скриншоты счетчиков и т. п.

    Совет

    Лучший способ сделать это — скопировать и вставить часовой пояс из таблицы в Википедии.

    sudo vi /etc/findface-security/config.py
    
    # time zone
    TIME_ZONE = 'America/Argentina/Buenos_Aires'
    
  6. (Опционально) В том же файле конфигурации вы можете изменить язык веб-интерфейса по умолчанию.

    # language code
    LANGUAGE_CODE = 'es-ar'
    
  7. Перезапустите сервис findface-security.

    sudo systemctl restart findface-security.service
    
  8. Загрузите файл лицензии FindFace Multi через основной веб-интерфейс http://<IP_адрес_сервера>/#/license. Для доступа в веб-интерфейс используйте логин и пароль пользователя superuser, выведенные в консоли.

    Примечание

    IP-адрес сервера в ссылках на веб-интерфейсы FindFace имеет вид 127.0.0.1 или <IP_адрес_в_сети>, в зависимости от того, принадлежит ли сервер к сети.

    Важно

    Не передавайте данные superuser (Супер Администратора) третьим лицам. Для администрирования системы создайте назначаемого администратора. Отличие назначаемого администратора от Супер Администратора в том, что последний не может лишиться прав администратора даже при смене роли.

  9. Ответы на вопросы инсталлятора были сохранены в файл /tmp/<findface-installer-*>.json. Вы можете отредактировать его и использовать для установки FindFace Multi на других серверах, не отвечая на вопросы повторно.

    Для этого выполните следующую команду:

    sudo ./findface-multi-1.2-and-server-5.2.run -f /tmp/<findface-installer-*>.json
    

    Совет

    Пример данного файла можно посмотреть в разделе Файл с параметрами установки.

Важно

Для того чтобы сохранить совместимость FindFace Multi со средой установки, настоятельно рекомендуется отключить автоматическое обновление Ubuntu. В этом случае вы сможете обновлять ОС вручную, контролируя процесс обновления отдельных пакетов.

Для отключения автоматического обновления Ubuntu выполните следующие команды:

sudo apt-get remove unattended-upgrades
sudo systemctl stop apt-daily.timer
sudo systemctl disable apt-daily.timer
sudo systemctl disable apt-daily.service
sudo systemctl daemon-reload

Важно

Сервисы FindFace Multi логируют большой объем данных, что в конечном итоге может привести к чрезмерной загрузке диска. Чтобы этого не произошло, рекомендуется отключить сервис rsyslog из-за его неоптимальной схемы ротации логов и вместо него использовать правильно настроенный сервис systemd-journal. См. пошаговые инструкции в разделе Логи сервисов.

Примечание

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