Установка в виде преднастроенной виртуальной машины

Вы можете развернуть FindFace Enterprise Server SDK в виде полностью настроенного готового к использованию образа виртуальной машины, работающего в среде виртуализации на любой операционной системе. Данный тип установки является самым простым и требует минимальных навыков.

Важно

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

Предупреждение

Для высоконагруженных проектов установка в виде виртуальной машины не рекомендуется даже в тестовых целях.

Важно

Мы официально поддерживаем только среды виртуализации на базе продуктов VMware. Установите необходимое программное обеспечение, перед тем как приступить к выполнению настоящей инструкции.

Совет

Для получения образа виртуальной машины обратитесь к своему менеджеру NtechLab по адресу info@ntechlab.com. Вам будут предоставлены файлы ffserver-*.ovf и disk-*.vmdk (по отдельности или в архиве).

Образ виртуальной машины содержит следующее предустановленное программное обеспечение:

  • Ubuntu Sever 16.04 LTS x64 без графического интерфейса пользователя

  • FindFace Enterprise Server SDK в следующей конфигурации:

    Компонент Особенности установки
    findface-facenapi Устанавливается и запускается с включенной и настроенной группировкой лиц одного человека в базе данных и распознаванием «свой-чужой».
    findface-nnapi Устанавливается и запускается (в 1 экземпляре) с включенным и настроенным распознаванием пола, возраста и эмоций. Может потребоваться балансировка нагрузки.
    findface-server-tarantool (tntapi) Устанавливается и запускается (1 шард). Может потребоваться шардинг.
    findface-tarantool-build- index Устанавливается. Перед использованием ознакомьтесь c документацией по компоненту.
    ffupload Устанавливается и запускается.
    fkvideo_detector Устанавливается. Для ручного запуска используйте командную строку или веб-интерфейс FindFace Web UI. Перед использованием ознакомьтесь с документацией по компоненту.
    Extraction API Устанавливается. Только для опытных пользователей. Перед использованием обязательно ознакомьтесь с документацией по компоненту.
    NTLS Устанавливается и запускается.
    Веб-интерфейс FindFace Устанавливается и запускается.
    findface-mass-enroll Устанавливается. Для работы с компонентом используйте командную строку. Перед использованием ознакомьтесь с документацией по компоненту.
    nginx Устанавливается и запускается.
    MongoDB Устанавливается и запускается.
    Tarantool Database Устанавливается и запускается.
    jq Устанавливается. Используется для структурирования API-ответов от FindFace Enterprise Server SDK в формате JSON.

Для развертывания FindFace Enteprise Server SDK в виде виртуальной машины выполните следующие действия:

  1. Поместите файлы виртуальной машины ffserver-*.ovf и disk-*.vmdk в общий каталог.

  2. Запустите среду виртуализации. Нажмите Open a Virtual Machine и выберите файл ffserver-*.ovf. По запросу конвертируйте файл в формат VMware. Это может занять некоторое время.

  3. По завершении импорта виртуальной машины в среду виртуализации откройте настройки ее аппаратного обеспечения: Edit virtual machine settings ‣ Hardware.

    Совет

    Ознакомьтесь с официальной документацией VMware.

    • Выберите тип сетевого подключения с учетом сетевой конфигурации хоста.

    • По умолчанию аппаратное обеспечение виртуальной машины уже настроено таким образом, чтобы обеспечить оптимальную производительность в большинстве систем со средней нагрузкой. Убедитесь, что оно удовлетворяет требованиям и вашего проекта. Если вы собираетесь одновременно обрабатывать несколько видеопотоков или работать с большим объемом данных, увеличьте RAM виртуальной машины и количество ядер процессора. Сохраните настройки.

      Важно

      Для еще большего увеличения производительности создайте дополнительные шарды tntapi и настройте балансировку нагрузки findface-nnapi после выполнения данной инструкции (через консоль виртуальной машины).

  4. Включите виртуальную машину, нажав Power On. Дождитесь окончания загрузки Ubuntu.

  5. Для входа в систему введите логин user и пароль ntechlab.

  6. Определите IP-адрес основного сетевого интерфейса виртуальной машины (192.168.112.144 в примере).

    ifconfig
    
    ens33 Link encap:Ethernet HWaddr 00:0c:29:8f:db:d5
    inet addr:192.168.112.144 Bcast:192.168.112.255 Mask:255.255.255.0
    inet6 addr: fe80::20c:29ff:fe8f:dbd5/64 Scope:Link
    UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
    RX packets:37751 errors:0 dropped:0 overruns:0 frame:0
    TX packets:36205 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000
    RX bytes:5621377 (5.6 MB) TX bytes:39193951 (39.1 MB)
    
    lo Link encap:Local Loopback
    inet addr:127.0.0.1 Mask:255.0.0.0
    inet6 addr: ::1/128 Scope:Host
    UP LOOPBACK RUNNING MTU:65536 Metric:1
    RX packets:152521 errors:0 dropped:0 overruns:0 frame:0
    TX packets:152521 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000
    RX bytes:24549909 (24.5 MB) TX bytes:24549909 (24.5 MB)
    
  7. Присвойте IP-адрес основного сетевого интерфейса параметру ffupload_url в файле конфигурации findface-facenapi.

    sudo vi /etc/findface-facenapi.ini
    
    ffupload_url = 'http://192.168.112.144:3333'
    

    Предупреждение

    Содержимое файла findface-facenapi.ini должно представлять собой синтаксически верный код Python.

  8. Перезапустите сервисы FindFace Enterprise Server SDK.

    sudo service 'findface*' restart
    
  9. Сделайте IP-адрес виртуальной машины статическим. Для этого откройте файл etc/network/interfaces и измените текущую запись для основного сетевого интерфейса так, как показано в примере ниже. Замените адреса в примере на актуальные с учетом настроек сети.

    Важно

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

    sudo vi /etc/network/interfaces
    
    # The primary network interface
    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
    
  10. Перезапустите сетевые интерфейсы.

    sudo service networking restart
    
  11. Загрузите файл лицензии FindFace Enterprise Server SDK через веб-интерфейс NTLS http://<IP_адрес>:3185/#/ (http://192.168.112.144:3185/#/ в примере).

  12. Создайте токен авторизации. Используйте его для доступа к веб-интерфейсу FindFace по адресу http://<IP_адрес>:8000/.