.. _vms_cleanup:


Remove Video Records
=======================================================

.. seealso::
   :ref:`configure-vms`

There are two methods of video archive cleanup available in the system:

#. Regular cleanup
#. Manual cleanup via a console command

.. rubric:: In this section:

.. contents::
   :local:


.. _regular-cleanup:

Regular Video Cleanup
----------------------------------------

To configure the regular video cleanup, do the following:

#. Open the ``/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py`` configuration file.

   .. code::

      sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

#. Find the ``SERVICES`` section and set ``"vms_cleanup": True``.

   .. code::

      SERVICES = {
          "ffsecurity": {
              ...
              "vms_cleanup": True,
          }
      }

#. Find the ``VMS_CLEANUP_SETTINGS`` section and configure what video to remove, using the following parameters:

   * ``'CLEANUP_BETWEEN_TRACKS'``: set ``True`` to remove video intervals that do not contain recognition events.
   * ``'CLEANUP_ARCHIVE'``: set ``True`` to remove the entire video archive older than a given number of days.
   * ``'ARCHIVE_CLEANUP_AGE'``: the maximum age of a video archive in the system, days. Applicable if ``'CLEANUP_ARCHIVE': True``.
   * ``'BETWEEN_TRACKS_CLEANUP_START_AGE'``: time period (days) during which the entire video archive is kept in the system. After this period is over, the system starts cleaning up between tracks according to the ``CLEANUP_BETWEEN_TRACKS`` settings.
   * ``'KEEP_EVENT_TYPES'``: event types that will be kept in the video archive, in the form of a dictionary, e.g., ['face', 'body', 'car'].
   * ``'KEEP_EVENT_BEFORE_AFTER'``: interval before and after a track with events that won't be removed in order to preserve meaningful information related to them, seconds. The value must be less than ``CLEANUP_THRESHOLD``.
   * ``'CLEANUP_THRESHOLD'``: minimum interval between tracks with events, seconds. If the interval between tracks is shorter, it won't be removed.


   .. code::

      'VMS_CLEANUP_SETTINGS': {
          'CLEANUP_BETWEEN_TRACKS': True,
          'CLEANUP_ARCHIVE': True,
          'ARCHIVE_CLEANUP_AGE': 30,  # days
          'BETWEEN_TRACKS_CLEANUP_START_AGE': 0,  # days
          'KEEP_EVENT_TYPES': ['face', 'body', 'car'],
          # Add `safe_time_interval` in seconds to each `track` subject to delete
          # Prevents deletion of essential data.
          # Should be lower than CLEANUP_THRESHOLD
          'KEEP_EVENT_BEFORE_AFTER': 10,  # minimal allowed value
          # Threshold between `intervals` in seconds.
          # If duration between `tracks` < `CLEANUP_THRESHOLD`
          # interval between tracks will not be added to deletion tasks
          'CLEANUP_THRESHOLD': 360,  # minimal allowed value
      },

#. Find the ``'VMS_CLEANUP_SERVICE_SCHEDULE'`` parameter and specify a recurrence rule (RRULE) for scheduling video cleanup.

   .. tip::

      See the RRULE calculator `here <https://jkbrzt.github.io/rrule/>`__.

   .. code::

      # rrule (recurrence rule) for scheduling `vms_cleanup` service
      'VMS_CLEANUP_SERVICE_SCHEDULE': 'RRULE:FREQ=HOURLY;INTERVAL=3;WKST=MO',

#. Restart all FindFace Multi containers.

   .. code::

      cd /opt/findface-multi/

      sudo docker-compose restart



Manual Video Cleanup
-----------------------

You can manually remove video chunks older than the given number of days by executing the command below. To set the number of days, use the --vms-videos-max-age argument.

.. code::

   sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup_vms --vms-videos-max-age=30



.. _vms_cleanup_ui:

Enable VMS Cleanup Settings
---------------------------------------

#. If a Video Recorder is :ref:`deployed <installer>` and :ref:`configured <configure-vms>`, VMS cleanup settings will be available in UI. You can find global VMS cleanup settings on the :guilabel:`Settings` → :guilabel:`General` → :guilabel:`VMS cleanup settings` tab. Custom settings are configured per :ref:`camera <video_processing_parameters>`.

   .. tip::

      If you did not install Video Recorder during the :ref:`standalone FindFace Multi deployment <installer>`, VMS cleanup settings are disabled in the UI by default. Deploy Video Recorder, following the :ref:`detailed instructions <deploy-vms>`. Then, configure the ``vms`` parameter in the ``/opt/findface-multi/configs/findface-multi-legacy/ui-config.yaml`` configuration file.

         .. code::

          sudo vi /opt/findface-multi/configs/findface-multi-legacy/ui-config.yaml

          vms:
            enabled: true


#. Make sure that VMS cleanup service is enabled in the ``/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py`` configuration file. Find the ``SERVICES`` section and set ``"vms_cleanup": True``.

   .. code::

      SERVICES = {
          "ffsecurity": {
              ...
              "vms_cleanup": True,
          }
      }


#. Restart all FindFace Multi containers.

   .. code::

      cd /opt/findface-multi/

      sudo docker-compose restart