STEP 3. Server preparation

CPU server preparation

To prepare a CPU server to FindFace Lite, please, install Docker Engine (19.03+) and Docker Compose (2.2.3+) .

Before you install Docker Engine (19.03+) and Docker Compose (2.2.3+) for the first time on a new host machine, you need to set up the Docker repository.

Steps from setting up the Docker repository to Docker and Docker Compose installation are described in the guides for Ubuntu OS and CentOS below.

Ubuntu OS

Update apt and install packages for data encryption to use the repository over HTTPS:

sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

Add the GPG key given by Docker. Use the command below:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Add the Docker repository using the following command:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update the apt:

sudo apt-get update

Install Docker and Docker Compose Plugin:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Check on how the Docker was installed using the command which downloads a test image and runs it in a container:

sudo docker run hello-world
The container will be started, you will see the operation success message, then the container will automatically be stopped.

Make sure the Docker Compose Plugin is also installed correctly. Use the following command to check:

docker compose version

Now all requirements for FindFace Lite are followed, please, go to the next STEP to upload FindFace Lite installer and license on the server.

CentOS

Install the yum-utils package and set up the repository. Use the command below:

sudo yum install -y yum-utils
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

Install Docker and Docker Compose Plugin:

sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Note

If prompted to accept the GPG key, verify that the fingerprint matches 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35 value, and if so, accept it.

Start Docker using the following command:

sudo systemctl start docker

Check on how the Docker was installed using the command which downloads a test image and runs it in a container:

sudo docker run hello-world
The container will be started, you will see the operation success message, then the container will automatically be stopped.

Make sure the Docker Compose Plugin is also installed correctly. Use the following command to check:

docker compose version

Now all requirements for FindFace Lite are followed, please, go to the next STEP to upload FindFace Lite installer and license on the server.

GPU server preparation

To prepare a GPU server to FindFace Lite, please, install NVIDIA Container Toolkit.

Before you install NVIDIA Container Toolkit for the first time on a new host machine, you need to prepare server according requrements:

NVIDIA Linux drivers >= 418.81.07 (note that older driver releases or branches are unsupported, to install drivers go to the official NVIDIA guide);
NVIDIA GPU with Architecture >= Kepler;
Docker >= 19.03.

Steps from checking GPU server configuration to the Docker software and NVIDIA Container Toolkit installation are described in the guides for Ubuntu OS and CentOS below.

Ubuntu OS

Chek the GPU drivers version using the command below:

nvidia-smi
Driver Version: should be >= 418.81.07.

If it is not so, please, go to the official NVIDIA guide to install the drivers.

Check a graphics card model using command below:

nvidia-smi -L

Verify that graphics card has architecture >= Kepler. Find your graphics cards model in the list below and check:

Architecture (from the oldest to the newest)

Series

Fermi

GeForce 400 and 500: GTX 480, GTX 470, GTX 580, GTX 570;

Kepler

GeForce 600 and 700: Nvidia GTX 680, 670, 660, GTX 780, GTX 770;

Maxwell

GeForce 900: GTX 960, GTX 970, GTX 980;

Pascal

GeForce 1000: GTX 1050, 1050 Ti, 1060, 1080;

Turing

GeForce RTX 2000 and GTX 1600: GTX 1660, GTX 1650, RTX 2060, RTX 2080;

Ampere

GeForce RTX 3080, RTX 3090, RTX 3070, etc.

Install the latest version of Docker using the command below:

  curl https://get.docker.com | sh \

&& sudo systemctl --now enable docker
Warning

If the command doesn’t work, please, follow all the steps of Docker installation on CPU server.

Setup the NVIDIA package repository and the GPG key:

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
  && curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
  && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | \
        sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
        sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

Update the apt package:

sudo apt-get update

Install the nvidia-docker2 package and dependencies:

sudo apt-get install -y nvidia-docker2

Restart the Docker daemon to complete the installation after setting the default runtime:

sudo systemctl restart docker

Check the runtime in the config:

cat /etc/docker/daemon.json
If there is the nvidia-container-runtime in the output, installation is succesful.

Now all requirements for FindFace Lite are followed, please, go to the next STEP to upload FindFace Lite installer and license on the server.

CentOS

Chek the GPU drivers version using the command below:

nvidia-smi
Driver Version: should be >= 418.81.07.

If it is not so, please, go to the official NVIDIA guide to install the drivers.

Check graphics card model using command below:

nvidia-smi -L

Verify that graphics card has architecture >= Kepler. Find your graphics cards model in the list below and check:

Architecture (from the oldest to the newest)

Series

Fermi

GeForce 400 and 500: GTX 480, GTX 470, GTX 580, GTX 570;

Kepler

GeForce 600 and 700: Nvidia GTX 680, 670, 660, GTX 780, GTX 770;

Maxwell

GeForce 900: GTX 960, GTX 970, GTX 980;

Pascal

GeForce 1000: GTX 1050, 1050 Ti, 1060, 1080;

Turing

GeForce RTX 2000 and GTX 1600: GTX 1660, GTX 1650, RTX 2060, RTX 2080;

Ampere

GeForce RTX 3080, RTX 3090, RTX 3070, etc.

Setup the official Docker CE repository:

sudo yum-config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

Install the containerd.io package:

sudo yum install -y https://download.docker.com/linux/centos/7/x86_64/stable/Packages/containerd.io-1.4.3-3.1.el7.x86_64.rpm

Install the latest version of Docker using the command below:

sudo yum install docker-ce -y

Ensure the Docker service is running with the following command:

sudo systemctl --now enable docker

Test your Docker installation by running the hello-world container:

sudo docker run --rm hello-world
The container will be started, you will see the operation success message, then the container will automatically be stopped.

After Docker is installed continue with NVIDIA installation. Setup the repository and the GPG key using the command below:

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
    && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.repo | sudo tee /etc/yum.repos.d/nvidia-container-toolkit.repo

Update the yam package:

sudo yum clean expire-cache

Install the nvidia-docker2 package and dependencies:

sudo yum install -y nvidia-docker2

Restart the Docker daemon to complete the installation after setting the default runtime:

sudo systemctl restart docker

Check the runtime in the config:

cat /etc/docker/daemon.json

If there is the nvidia-container-runtime in the output, installation is succesful.

Now all requirements for FindFace Lite are followed, please, go to the next STEP to upload FindFace Lite installer and license on the server.