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

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

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

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

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

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

Устанавливаемый продукт: FindFace Multi.
Тип установки:
- 1: установить FindFace Multi на одиночном физическом сервере.
- 2: установить FindFace Multi в качестве центрального сервера и настроить его на взаимодействие с дополнительными удаленными серверами findface-video-worker.
  
  Совет
  
  Для отдельной установки findface-video-worker см. Дополнительное развертывание findface-video-worker на удаленных серверах.
- 3: установить apt-репозиторий для пошагового развертывания.
- 4: полностью настраиваемая установка.
Примечание

Если вы выбрали тип установки №3 или №4, не забудьте установить необходимые модели нейронных сетей вместе с компонентом findface-extraction-api.
Тип пакета findface-video-worker: CPU или GPU.
Тип пакета findface-extraction-api: CPU или GPU.
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/

Укажите свою временную зону в файле конфигурации /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'
```
(Опционально) В том же файле конфигурации вы можете изменить язык веб-интерфейса по умолчанию.
```
# language code
LANGUAGE_CODE = 'es-ar'
```
См.также

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

Примечание

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

Важно

Не передавайте данные superuser (Супер Администратора) третьим лицам. Для администрирования системы создайте назначаемого администратора. Отличие назначаемого администратора от Супер Администратора в том, что последний не может лишиться прав администратора даже при смене роли.
Ответы на вопросы инсталлятора были сохранены в файл /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. См. пошаговые инструкции в разделе Логи сервисов.

Примечание

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