Deploy from Console Installer

To deploy FindFace, use a developer-friendly console installer.

Tip

Before deployment, be sure to consult the system requirements.

Important

The FindFace host must have a static IP address in order to be running successfully. To make the IP address static, open the /etc/network/interfaces file and modify the current primary network interface entry as shown in the case study below. Be sure to substitute the suggested addresses with the actual ones, subject to your network specification.

sudo vi /etc/network/interfaces

iface eth0 inet static
address 192.168.112.144
netmask 255.255.255.0
gateway 192.168.112.254
dns-nameservers 192.168.112.254

Restart networking.

sudo service networking restart

Be sure to edit the etc/network/interfaces file with extreme care. Please refer to the Ubuntu guide on networking before proceeding.

To deploy FindFace from the console installer, do the following:

Download the installer file findface-security-and-server-4.5.run.
Put the .run file into some directory on the designated host (for example, /home/username).

From this directory, make the .run file executable.

chmod +x findface-security-and-server-4.5.run

Execute the .run file.
```
sudo ./findface-security-and-server-4.5.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.
2. Installation type:
  - 1: install FindFace standalone.
  - 2: install FindFace 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 on other hosts without having to answer the questions again.

Should you choose to install FindFace standalone, its components will be automatically installed, configured and/or started in the following configuration:

Important

In the case of a clean install, the installer will automatically configure findface-extraction-api to use the jackfruit_480 neural network. Otherwise, you will be able to choose between jackfruit_480 and the previous model. It is strictly not recommended to use the installer to update the system.

After the installation is complete, the following output is shown on the console:

Tip

Be sure to save this data: you will need it later.
```
#############################################################################
#                       Installation is complete                            #
#############################################################################
- upload your license to http://172.20.77.17/#/license/
- user interface: http://172.20.77.17/
  superuser:      admin
  password:       admin
  documentation:  http://172.20.77.17/doc/
```
Upload the FindFace license file via the main web interface http://<Host_IP_address>/#/license. To access the web interface, use the provided admin credentials.

Note

The host IP address is shown in the links to 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.

Important

Do not disclose the superuser (Super Administrator) credentials to others. To administer the system, create a new user with administrator privileges. Whatever the role, the Super Administrator cannot be deprived of its rights.
To automatically install FindFace on another host without answering the installation questions, use the /tmp/<findface-installer-*>.json file. Execute:
```
sudo ./findface-security-and-server-4.5.run -f /tmp/<findface-installer-*>.json
```
Tip

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