FindFace Video Worker Deployment on Remote Hosts

You can install findface-video-worker instances apart from the FindFace Multi principal server when creating a multi-host environment.

Important

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

Allow accessing the findface-ntls license server from any IP address. To do so, open the /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml configuration file on the server with findface-ntls and set listen: 0.0.0.0:3133. Restart the findface-multi-findface-ntls-1 container.
```
sudo vi /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml

listen: 0.0.0.0:3133
```
```
sudo docker container restart findface-multi-findface-ntls-1
```
Allow accessing the findface-video-manager service from any IP address. To do so, open the /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml 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-multi-findface-video-manager-1 container.
```
sudo vi /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml

listen: 0.0.0.0:18810
...
rpc:
  listen: 0.0.0.0:18811
```
```
sudo docker container restart findface-multi-findface-video-manager-1
```
On the FindFace Multi server, open the /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py configuration file and make sure that the ROUTER_URL parameter contains the external IP address of the FindFace Multi server and not the localhost. The findface-video-worker instances on the remote hosts will be using this address for posting objects.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.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 meet the system requirements and prepare the server first.

Download the installer file findface-*.run.
Put the .run file into some directory on the designated host (for example, /home/username).
From this directory, make the .run file executable.

Note

Be sure to specify the actual file name instead of findface-*.
```
chmod +x findface-*.run
```
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. Q: Which product should be installed?
  
  A: 3
```
1. [multi   ]  FindFace Multi
2. [server  ]  FindFace Server
3. [video-worker]  FindFace Video Worker

(default: multi)
product> 3
```
2. Q: Which variant of Video Worker should be installed?
  
  A: Specify the findface-video-worker package type, CPU or GPU.
```
Which variant of Video Worker should be installed?

-  1 [cpu]  CPU-based implementation, slower but doesn't require GPU
-  2 [gpu]  CUDA-based implementation of video detector, requires NVIDIA GPU
```
3. Q: Found X interface(s). Which one should we announce as our inter-service communication address?
  
  A: Choose the default interface 2 to connect to the FindFace Multi server. We don’t recommend you to use localhost.
```
Found 1 interface(s). Which one should we announce as our external address?

-  1 [lo      ]  127.0.0.1
-  2 [ens3    ]  192.168.112.254

(default: 192.168.112.254)
inter_ip.advertised> 2
```
4. Q: Please enter FF.Multi or FF.Server IP address:
  
  A: Specify the FindFace Multi server IP address.
```
Please enter FF.Multi or FF.Server IP address:
server_addr> 192.168.112.25
```
After that, the installation process will automatically begin.

Important

If you chose to install findface-ntls and/or findface-video-manager on different hosts than that with findface-multi-legacy, specify their IP addresses in the /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml configuration file after the installation.

/opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

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 install a findface-video-worker instance 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 active progress:

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

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

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