.. _custom-installation:

Fully Customized Installation 
---------------------------------------------------------------
	
The FindFace developer-friendly :ref:`installer <installer>` provides you with a few installation options, including the fully customized installation. This option is mostly used when deploying FindFace in a highly distributed environment and requires a certain level of knowledge and experience.


To initiate the fully customized installation, do the following:

#. 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-*``.

   .. code::

      chmod +x findface-*.run

#. Execute the ``.run`` file.

   .. code::

      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 :kbd:`Enter`. The questions and answers are the following:

   #. Q: ``Which product should be installed?``

      A: ``1``

      .. code::

         Which product should be installed?

           1. [security]  FindFace Multi
           2. [server  ]  FindFace Server
           3. [video-worker]  FindFace Video Worker
           4. [nvidia-drivers]  NVIDIA CUDA drivers (installed automatically when you install gpu-variant of the products above)

         (default: security)
         product> 1

   #. Q: ``Please choose installation type:``

      A: ``4`` 

      .. code::

         Please choose installation type:

         -  1 [stand-alone ]  Single Server
         -  2 [multi-worker]  Single Server, Multiple video workers
         -  3 [repo        ]  Don't install anything, just set up the APT repository
         -  4 [custom      ]  Fully customized installation

         (default: stand-alone)
         type> 4

   #. Q: ``Found X interface(s). Which one should we announce as our external address?``

      A: Choose the interface that you are going to use as the instance IP address. 

      .. code::

         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)
         ext_ip.advertised> 2

   #. Q: ``Found X interface(s). Which one should we announce as our inter-service communication address?``

      A: Choose the interface for inter-service communication. 

      .. code::

         Found 1 interface(s). Which one should we announce as our inter-service communication address?

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

         (default: 192.168.112.254)
         inter_ip.advertised> 2

   #. Q: ``Please select FindFace Multi components to install:``

      A: Choose FindFace components to install. By default, all components are subject to installation. You can leave it as is by entering ``done``, or select specific components. Whenever you have to make a selection, first, deselect all the listed components by entering ``*`` in the command line, then select required components by entering their sequence number (keyword), for example: ``1 7 13``, etc. Enter ``done`` to save your selection and proceed to another step.  

      .. code::

         Please select FindFace Multi components to install:

         -  1 [v]  findface-data        - Face recognition models
         ...
         ...
  
         Enter keyword to select matching choices or -keyword to clear selection.
         Enter "done" to save your selection and proceed to another step.
         components> done

   #. Specific questions related to the selected components: acceleration type, the required number of component instances, neural network models, etc. If you are experiencing a difficulty answering them, try to find an answer in this documentation, or submit your question to support@ntechlab.com.