Additional findface-video-worker Deployment on Remote Hosts

Important

Before deploying findface-video-worker instances on remote hosts, do the following:

  1. Allow accessing the findface-ntls license server from any IP address. To do so, open the /etc/findface-ntls.cfg configuration file on the server with findface-ntls and set listen = 0.0.0.0:3133. Restart the findface-ntls service.

    sudo vi /etc/findface-ntls.cfg
    
    ## Address to accept incoming client connections (IP:PORT)
    ## type:string env:CFG_LISTEN longopt:--listen
    listen = 0.0.0.0:3133
    
    sudo systemctl restart findface-ntls.service
    
  2. Allow accessing the findface-video-manager service from any IP address. To do so, open the /etc/findface-video-manager.conf configuration file on the server with findface-video-manager and set listen: 0.0.0.0:18810 and rpc:listen: 0.0.0.0:18811. Restart the findface-video-manager service.

    sudo vi /etc/findface-video-manager.conf
    
    listen: 0.0.0.0:18810
    ...
    rpc:
      listen: 0.0.0.0:18811
    
    sudo systemctl restart findface-video-manager.service
    
  3. On the FindFace server, open the /etc/findface-security/config.py configuration file and make sure that the ROUTER_URL parameter contains the external IP address of the FindFace server and not the localhost. The findface-video-worker instances on the remote hosts will be using this address for posting objects.

    sudo vi /etc/findface-security/config.py
    
    ...
    
    'ROUTER_URL': 'http://192.168.0.12',
    
    ...
    

To install only a findface-video-worker service, do the following:

Tip

Before deployment, be sure to consult the system requirements.

Tip

If you have several video cards on your server, see Multiple Video Cards Usage before deploying findface-video-worker-gpu.

  1. Download the installer file findface-*.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.

    Note

    Be sure to specify the actual file name instead of findface-*.

    chmod +x findface-*.run
    
  4. Execute the .run file.

    sudo ./findface-*.run
    

    The installer will ask you a few questions and perform several automated checks to ensure that the host meets the system requirements. After filling out each prompt, press Enter. The questions and answers are the following:

    1. Product to install: FindFace Video Worker.

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

    3. IP address of the findface-security host.

    After that, the installation process will automatically begin.

Note

If you chose to install findface-ntls and/or findface-video-manager on different hosts than that with findface-security, specify their IP addresses in the /etc/findface-video-worker-cpu.ini (/etc/findface-video-worker-gpu.ini) configuration file after the installation.

sudo vi /etc/findface-video-worker-cpu.ini
sudo vi /etc/findface-video-worker-gpu.ini

In the ntls-addr parameter, specify the findface-ntls host IP address.

ntls-addr=127.0.0.1:3133

In the mgr-static parameter, specify the findface-video-manager host IP address, which provides findface-video-worker with settings and the video stream list.

mgr-static=127.0.0.1:18811

Tip

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

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

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

Important

To preserve the FindFace compatibility with the installation environment, we highly recommend you to disable the Ubuntu automatic update. In this case, you will be able to update your OS manually, fully controlling which packages to update.

To disable the Ubuntu automatic update, execute the following commands:

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

Important

The FindFace services log a large amount of data, which can eventually lead to disc overload. To prevent this from happening, we advise you to disable rsyslog due to its suboptimal log rotation scheme and use the appropriately configured systemd-journal service instead. See Service Logs for the step-by-step instructions.