Deploy and Remove FindFace Multi

Docker platform

FindFace Multi 2.0+ is Docker-based. You must install and start a set of Docker products before proceeding with the FindFace Multi deployment. For your convenience, this chapter contains the Ubuntu Server Preparation section covering the intricacies of installing Docker on Ubuntu. For other platforms, please refer to the Docker documentation.

NVIDIA driver and NVIDIA Container Runtime (GPU only)

If you intend to deploy FindFace Multi with GPU-acceleration, you need to install the NVIDIA driver and NVIDIA Container Runtime. Again, you will find the relevant information in the Ubuntu Server Preparation section.

Deployment options

After you are finished with the server preparation, you are all set for the FindFace Multi deployment. You are provided with the following options here:

  1. Automatically install FindFace Multi standalone in one run. Being the simplest, this installation type is excellent to kick-start your experience with FindFace Multi. We recommend choosing it if you are a first-timer. See FindFace Multi Standalone Automated Deployment for guidance.

  2. Automatically install FindFace Multi and configure it to interact with additional remote findface-video-worker instances. This installation type is for those who are deploying FindFace Multi in a multi-host environment. It requires a bit of technical expertise and knowledge of the product architecture. To automatically install only FindFace Video Worker (findface-video-worker) on a remote host, refer to the FindFace Video Worker Deployment on Remote Hosts section.

  3. Fully customized installation. It requires fundamental understanding of the product architecture. See Fully Customized Installation.

Note

If you select the installation type #3, keep in mind to install necessary neural network models along with the findface-extraction-api component.

Installer questions and automatic deployment from the installation file

Before starting the actual installation, the installer asks you a few questions and performs several automated checks to ensure that the host meets the system requirements. After filling out each prompt, press Enter.

To install the same configuration of FindFace Multi on a different host, use the automatic deployment from the installation file. In this case, you won’t have to answer the installation questions again. The exact path to the installation file is displayed right after the last question, before the installer starts off active progress:

[I 2023-02-09 11:13:37,187 main:142] Your answers were saved to /tmp/findface-installer-p01n9sn3.json

Important

Be sure to remove fields *.config, exp_ip, and int_ip before installing FindFace Multi on a host with a different IP address.

To launch the automatic deployment from the /tmp/<findface-installer-*>.json file, execute:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

Post-development procedures and how-to’s

Browse through the Post-deployment Procedures and How-to’s section to learn how to set the time zone, license your instance, and configure logging. This section will also provide you with few basic commands that will help you to kick-start your work with FindFace Multi containers, in case you are a newbie with Docker.

Important

Starting the GPU-accelerated services findface-extraction-api and findface-video-worker for the first time after deployment may take a considerable amount of time due to the caching process (up to 45 minutes).

Important

Although FindFace Multi provides tools to ensure its protection from unauthorized access, they are not replacing a properly configured firewall. Be sure to use a firewall to heighten the FindFace Multi network protection.

Instance removal

To remove your instance, you must run a set of commands. See the Remove FindFace Multi Instance section.