.. _requirements: ************************** System Requirements ************************** .. rubric:: In this chapter: .. contents:: :local: .. _general-requirements: General Requirements ============================= Hosts -------------------- Prior to installing FindFace Enterprise Server SDK, ensure that the host(s) meet the following minimum requirements: .. note:: Standalone installation of FindFace Enterprise Server SDK is recommended when the number of faces in the database **does not** exceed some ``1,000,000``. Otherwise you should install Findface Enterprise Server SDK in a cluster environment and configure :ref:`fast index ` search. See :ref:`architecture` for details. +--------------------+-----------------------------------------------------------------------------+ | Requirement | Description | +====================+=============================================================================+ | CPU | x86-64 CPU (Intel), >2.0 Ghz, >2 cores. | | | The CPU AVX support is required for operation of all the components, | | | except findface-upload. | +--------------------+-----------------------------------------------------------------------------+ | RAM | RAM consumption depends on the number of faces in your dataset. | | | Use the benchmark results :ref:`below ` to calculate | | | the memory size you need. | | | Note that if there are 2 or more galleries with facens, you have to | | | multiply the given MongoDB and Tarantool RAM consumption by the relevant | | | number of galleries. | | | As a rule, ``10,000,000`` faces require 20Gb RAM for Tarantool. MongoDB | | | does not need much RAM as it uses HDD as RAM when needed. | +--------------------+-----------------------------------------------------------------------------+ | HDD | ``10,000,000`` faces require ~20x[number of snapshots for each shard] GB | | | for Tarantool (by default 20x3=60 GB) and 24 GB for MongoDB. | | | To store all uploaded images via findface-upload: | | | size of all uploaded images + 10% | +--------------------+-----------------------------------------------------------------------------+ | Operating system | Ubuntu 16.04 LTS (only x64) | +--------------------+-----------------------------------------------------------------------------+ | Virtual machine | VMware | | support | | +--------------------+-----------------------------------------------------------------------------+ .. _RAM-benchmark: Here you can see the FindFace Enterprise Server SDK memory usage benchmark results. Use these data to calculate the RAM size you need. .. note:: Memory usage may slightly vary from test to test. .. note:: Depending on your needs, :ref:`adjust ` the Tarantool maximum memory usage at ``/etc/tarantool/instances.enabled/FindFace.lua``. .. note:: Starting with version 2.6, the ``nnapi`` component is deprecated, and ``extraction-api`` is used as a default facen extractor (as well as a default face detector). The testing setup is the following: * Facen :ref:`model `: ``apricot_320`` * Models for :ref:`gender, age and emotions recognition ` (GAE in the table): ``fr_1_gender0``, ``fr_1_age0``, ``emotion_1`` * Models used in :ref:`extraction-api `: ``apricot_320``, ``fr_1_gender0``, ``fr_1_age0``, ``emotion_1`` * ``MongoDB``, ``Tarantool``: facens are stored in one gallery. If there are 2 or more galleries with facens, multiply the given RAM amount by the relevant number of galleries. +-----------------+-----------------------------------------------------------------------------------------+ | Number of faces | RAM consumption by components, MB | | +-------------+--------------+----------+--------------------+----------------------------+ | | MongoDB | Tarantool | nnapi | nnapi + GAE | extraction-api | +=================+=============+==============+==========+====================+============================+ | 0 (own needs) | ~70 | ~77 | ~265 | ~1000 | ~1GB (1 Core)/~7GB | +-----------------+-------------+--------------+----------+--------------------+ (8 Cores) | | 50,000 | ~181 | ~189 | ~400 | ~1400 | (up to 10,5 under load) | +-----------------+-------------+--------------+----------+--------------------+ | | 100,000 | ~294 | ~263 | ~400 | ~1400 | | +-----------------+-------------+--------------+----------+--------------------+ | | 500,000 | ~1190 | ~1013 | ~400 | ~1400 | | +-----------------+-------------+--------------+----------+--------------------+ | | 1,000,000 | ~2310 | ~1943 | ~400 | ~1400 | | +-----------------+-------------+--------------+----------+--------------------+----------------------------+ Supported Images ----------------------------- FindFace Enterprise Server SDK supports the following image formats: * JPEG, * PNG, * WebP. The maximum image size is 10 MB. The minimum distance between pupils is 40 px. .. _video-requirements: Video Face Detection ================================= Video Face Detector Host ---------------------------------- A host for the :ref:`video face detection