.. _docker-commands:

Post-deployment Procedures and How-to's
---------------------------------------------------------------

After you are finished with the FindFace Multi deployment, perform the procedures below. 

.. rubric:: In this section:

.. contents::
   :local:


Specify Time Zone
^^^^^^^^^^^^^^^^^^^^^^

The time zone on the FindFace Multi server determines the time in reports, logs, and names of such FindFace Multi artifacts as detection full frames and thumbnails, etc. 

The time zone is specified in the ``/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py`` configuration file, either in the ``Region/Country/City`` or ``Etc/GMT+H`` format. The best way to do so is to copy/paste your time zone from `this table <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`_ on Wikipedia.

.. code::

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

   # time zone
   TIME_ZONE = 'America/Argentina/Buenos_Aires'

Restart the ``findface-multi-findface-multi-legacy-1`` container.

.. code::

   sudo docker container restart findface-multi-findface-multi-legacy-1

License Instance
^^^^^^^^^^^^^^^^^^^^^^

FindFace Multi provides several licensing options. Whichever option you choose, you upload the FindFace Multi license file via the main web interface ``http://<Host_IP_address>/#/license``. To access the web interface, use the ``superuser`` credentials.

.. 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.

Refer to the :ref:`licensing-principles` section to learn about the licensing options available.

Configure Logging
^^^^^^^^^^^^^^^^^^^^

By default, the FindFace Multi processes are logged to `Docker container logs <https://docs.docker.com/config/containers/logging/>`__,  which can be accessed via the ``docker logs`` and ``docker service logs`` commands. In addition, Docker uses the `json-file logging driver <https://docs.docker.com/config/containers/logging/json-file/>`__, which caches container logs in JSON.  You can configure Docker to use another logging driver, choosing from the `multiple logging mechanisms available <https://docs.docker.com/config/containers/logging/configure/>`__. See :ref:`logs` to learn how to do it.

.. _useful-docker-commands:

Useful Docker Commands
^^^^^^^^^^^^^^^^^^^^^^^^^

In order to efficiently and easily administer FindFace Multi, you must have extensive knowledge and skills with Docker. If you're new to Docker, get started with the commands below. Then explore the Docker documentation for additional skills.

* View all Docker containers, including the stopped ones:

  .. code::

     docker ps -a
 
  To get a more compact and understandable output, execute:

  .. code::

     docker ps -a --format "table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.State}}"
 
  To extend the previous output, execute:

  .. code::

     docker ps --format='{{json .}}' | jq

* Restart the Docker service:

  .. code::

     sudo systemctl restart docker
 
* View a container log if the ``journald`` logging driver is :ref:`enabled <logs>`:


  .. code::

     journalctl CONTAINER_NAME=findface-multi-findface-multi-legacy-1 -f

* Stop a Docker container:

  .. code::

     sudo docker container stop <container_name>/<container_id>

  Stop all Docker containers:

  .. code::

     sudo docker container stop $(sudo docker ps -a -q) 

* Start a Docker container:

  .. code::

     sudo docker container start <container_name>/<container_id>

  Start all Docker containers:

  .. code::

     sudo docker container start $(sudo docker ps -a -q) 
 
* The FindFace Multi ``docker-compose.yaml`` file can be viewed as such:

  .. code::

     cat /opt/findface-multi/docker-compose.yaml
     
* FindFace Multi configuration files can be found here: 

  .. code::

      cd /opt/findface-multi/configs/
 
  Once you made changes to a configuration file, restart a relevant container by executing:

  .. code::

     sudo docker container restart <container_name>/<container_id>

* Enter a running Docker container to execute a command in it:

  .. code::

     sudo docker container exec -it <container_name> /bin/bash

* Stop and remove all FindFace Multi containers:

  .. code::

     cd /opt/findface-multi
     sudo docker-compose down

* Build, recreate, and start FindFace Multi containers:

  .. code::

     cd /opt/findface-multi
     sudo docker-compose up -d