Install from Console Installer

To install FindFace Enterprise Server, use a developer-friendly console installer.

Tip

Be sure to consult the system requirements prior.

Do the following:

1. Download the installer file findface-security-2.1.0-server-3.1.0.run.

2. Put the .run file into some directory on the designated host (for example, /home/username).

3. From this directory, make the .run file executable.

   chmod +x findface-security-2.1.0-server-3.1.0.run
   

4. Execute the .run file.

   sudo ./findface-security-2.1.0-server-3.1.0.run
   

   The installer will ask you a few questions and perform several automated checks to ensure that the host meets the system requirements. Fill out the prompts appropriately once requested. The questions are the following:

   1. Product to install: FindFace Server.

   2. Installation type:

      • 1: install FindFace Enterprise Server standalone.

      • 2: install FindFace Enterprise Server and configure it to interact with additional remote findface-video-worker instances.

        Tip

        To install only findface-video-worker on a host, refer to Additional findface-video-worker deployment on remote hosts.

      • 3: install only the apt repository that can be further used for the step-by-step deployment.

        Important

        This installation type doesn’t provide installation of neural network models essential for the findface-extraction-api functioning. Be sure to manually install them on the host(s) with findface-extraction-api.

      • 4: fully customized installation.

        Important

        Be sure to manually install neural network models on the host(s) with findface-extraction-api.

   3. Type of findface-video-worker package: CPU or GPU.

   4. Type of findface-extraction-api package: CPU or GPU.

   Once all the questions answered, the answers will be saved to a file /tmp/<findface-installer-*>.json. You can edit this file and use it to install FindFace Enterprise Server on other hosts without having to answer the questions again.

   After that, the FindFace Enterprise Server components will be automatically installed, configured and/or started in the following configuration:

   Service	Configuration
   etcd	Installed and started.
   memcached	Installed and started.
   nginx	Installed and started.
   findface-ntls	Installed and started.
   findface-tarantool-server	Installed and started. The number of instances (shards) is calculated using the formula: N = max(min(mem_mb // 2000, cpu_cores), 1), i.e. it is equal to the RAM size in MB divided by 2000, or the number of CPU physical cores (but at least 1 shard).
   findface-extraction-api	Installed and started.
   findface-sf-api	Installed and started.
   findface-facerouter	Installed and started.
   findface-upload	Installed.
   findface-video-manager	Installed and started.
   findface-video-worker(-gpu)	Installed and started.
   findface-data-*	Neural network models for face and face features recognition (gender, age, emotions, glasses, beard). Installed.
   findface-gpudetector-data/	NTechLab gpu detector data. Installed.
   jq	Installed. Used to pretty-print API responses from FindFace Enterprise Server.

   Once the installation is complete, the following output will be shown on the console:

   Tip

   Be sure to save this data: you will need it later.

   #############################################################################
   #                       Installation is complete                            #
   #############################################################################
   - upload your license to http://127.0.0.1:3185/
   - FindFace SF-API address: http://172.20.77.78:18411/
   - FindFace VideoManager address: http://172.20.77.78:18411/
   

5. Upload the FindFace Enterprise Server license file via the findface-ntls web interface http://<ntls_host_IP_address>:3185.

   Note

   The IP address is shown in the links to the FindFace web services in the following way: as an external IP address if the host belongs to a network, or 127.0.0.1 otherwise.

6. To automatically install FindFace Enterprise Server on another host without answering the installation questions, use the /tmp/<findface-installer-*>.json file. Execute:

   sudo ./findface-security-2.1.0-server-3.1.0.run -f /tmp/<findface-installer-*>.json
   

   Tip

   You can find an example of the installation file in Installation File.