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

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

Совет

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

Важно

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

Загрузите файл инсталлятора findface-multi-1.0-and-server-5.0.1.run.
Поместите файл .run в любой каталог на сервере установки (например, /home/username).
Из данного каталога сделайте файл .run исполняемым.
```
chmod +x findface-multi-1.0-and-server-5.0.1.run
```

Запустите файл .run.

sudo ./findface-multi-1.0-and-server-5.0.1.run

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

Устанавливаемый продукт: FindFace Multi.
Тип установки:
- 1: установить FindFace Multi на одиночном физическом сервере.
- 2: установить FindFace Multi в качестве центрального сервера и настроить его на взаимодействие с дополнительными удаленными серверами findface-video-worker.
  
  Совет
  
  Для отдельной установки findface-video-worker см. Дополнительное развертывание findface-video-worker на удаленных серверах.
- 3: установить только apt-репозиторий для пошагового развертывания в будущем.
  
  Важно
  
  При данном типе установки модели нейронных сетей, необходимые для функционирования findface-extraction-api, не устанавливаются. Обязательно установите их вручную на серверах с findface-extraction-api.
- 4: полностью настраиваемая установка (установка нужных пакетов).
  
  Важно
  
  Обязательно установите модели нейронных сетей на серверах с findface-extraction-api.
Тип пакета findface-video-worker: CPU или GPU.
Тип пакета findface-extraction-api: CPU или GPU.

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

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

Важно

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

Сервис	Конфигурация
postgresql-10	Устанавливается и запускается.
redis-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	Устанавливается и запускается.
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 Multi. Устанавливается.
findface-security	Устанавливается и запускается.
findface-counter	Устанавливается и запускается.
findface-liveness-api	Устанавливается и запускается.
jq	Устанавливается. Используется для структурирования API-ответов от FindFace Multi в формате JSON.

По завершении установки в консоль будет выведена информация, необходимая для использования 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/

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

Примечание

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

Важно

Не передавайте данные superuser (Супер Администратора) третьим лицам. Для администрирования системы создайте назначаемого администратора. Отличие назначаемого администратора от Супер Администратора в том, что последний не может лишиться прав администратора даже при смене роли.
Для того чтобы автоматически установить FindFace Multi на других серверах, не отвечая на вопросы инсталлятора, используйте файл /tmp/<findface-installer-*>.json. Запустите инсталлятор следующей командой:
```
sudo ./findface-multi-1.0-and-server-5.0.1.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. См. пошаговые инструкции в разделе Логи сервисов.