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

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

Совет

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

Важно

Для успешного функционирования системы после установки из инсталлятора 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 из инсталлятора выполните следующие действия:

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

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

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

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

    sudo ./findface-security-and-server-4.5.run
    

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

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

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

      • 1: установить ПК FindFace на одиночном физическом сервере.

      • 2: установить ПК FindFace в качестве центрального сервера и настроить его на взаимодействие с дополнительными удаленными серверами findface-video-worker.

        Совет

        Для отдельной установки findface-video-worker см. Дополнительное развертывание findface-video-worker на удаленных серверах.

      • 3: установить только apt-репозиторий для пошагового развертывания в будущем.

        Важно

        При данном типе установки модели нейронных сетей, необходимые для функционирования findface-extraction-api, не устанавливаются. Обязательно установите их вручную на серверах с findface-extraction-api.

      • 4: полностью настраиваемая установка (установка нужных пакетов).

        Важно

        Обязательно установите модели нейронных сетей на серверах с findface-extraction-api.

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

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

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

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

    Важно

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

    Сервис

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

    postgresql-10

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

    redis-server

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

    etcd

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

    pgbouncer

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

    memcached

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

    nginx

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

    django

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

    findface-ntls

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

    findface-tarantool-server

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

    findface-extraction-api

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

    findface-sf-api

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

    findface-upload

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

    findface-video-manager

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

    findface-video-worker-*

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

    findface-data-*

    Модели нейронных сетей для распознавания лиц и их атрибутов (пол, возраст, эмоции, очки, борода, медицинская маска и др.). Устанавливаются.

    findface-gpudetector-data

    Данные gpu-детектора NTechLab. Устанавливается.

    python3-ntech.ffsecurity-client

    Библиотека клиента Python, используемая в API ПК FindFace. Устанавливается.

    findface-security

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

    findface-counter

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

    findface-liveness-api

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

    jq

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

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

    Совет

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

    #############################################################################
    #                       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. Загрузите файл лицензии через основной веб-интерфейс http://<IP_адрес_сервера>/#/license. Для доступа в веб-интерфейс используйте логин и пароль администратора, выведенные в консоли.

    Примечание

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

    Важно

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

  6. Для того чтобы автоматически установить ПК FindFace на других серверах, не отвечая на вопросы инсталлятора, используйте файл /tmp/<findface-installer-*>.json. Запустите инсталлятор следующей командой:

    sudo ./findface-security-and-server-4.5.run -f /tmp/<findface-installer-*>.json
    

    Совет

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

Важно

Для того чтобы сохранить совместимость ПК FindFace со средой установки, настоятельно рекомендуется отключить автоматическое обновление 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