.. _video-allocation:

Allocate ``findface-video-worker`` to Camera Group
======================================================

In a distributed architecture, it is often necessary that video streams from a group of cameras be processed *in situ*, without being redistributed across remote ``findface-video-worker`` instances by the principal server. 

.. note:: 
   Among typical use cases are hotel chains, chain stores, several security checkpoints in the same building, etc. 

In this case, allocate the local ``findface-video-worker`` to the camera group.

Do the following:

#. Navigate to the :guilabel:`Preferences` tab. Click :guilabel:`Camera Groups`.
#. Open the camera group settings.
#. In the :guilabel:`Labels`, create or select one or several allocation labels. Save changes.
#. Open the ``/etc/findface-video-worker-cpu.ini`` (``/etc/findface-video-worker-gpu.ini``) configuration file and specify the allocation labels in the following format: ``label_name=true`` (label ``terminal_1`` in the example below).

   .. code::

      sudo vi /etc/findface-video-worker-cpu.ini
      sudo vi /etc/findface-video-worker-gpu.ini
      
      labels = terminal_1=true

#. Restart ``findface-video-worker``.

   .. code::

      sudo systemctl restart findface-video-worker-cpu.service
      sudo systemctl restart findface-video-worker-gpu.service

.. note::
   If a camera is assigned an allocation label, its video stream can be processed by a ``findface-video-worker`` instance with the same label, as well as by all unlabeled ``findface-video-worker`` instances.

.. warning::
   If a labeled camera is processed by an unlabeled ``findface-video-worker`` instance and a free similar-labeled instance appears, the camera won’t automatically switch to the latter. To switch the camera, restart the similar-labeled ``findface-video-worker`` instance.