.. offer-diff:

Audit comparatif entre 2 offres de stockage miroirs
###################################################

Une offre de stockage peut être désynchronisée par rapport à une autre à la suite d'une indisponibilité plus ou moins longue voire totale de l'offre (`crash` majeur du système, panne matérielle etc.) ou bien encore à la suite d'une mise en maintenance programmée.

Le mécanisme d'audit comparatif entre 2 offres est un audit technique à disposition de l'exploitant. Il permet d'identifier l'ensemble des fichiers désynchronisés entre les 2 offres (existence et size).


Procédure de lancement et de suivi de l'audit comparatif d'offres
=================================================================

Le déclenchement se fait de la manière suivante :

.. code-block:: bash

   ansible-playbook ansible-vitam-exploitation/diff_offers.yml -i environments/hosts.<environnement> --ask-vault-pass -e "offer1=offer-fs1.service.dc1.consul offer2=offer-fs-2.service.dc2.consul container=units,objects tenants=0,1,2"

* Le paramètre ``offer1`` spécifie l'identifiant complet de la première offre à comparer (<nom_offre>.service.<vitam_site_name>.consul).
* Le paramètre ``offer2`` spécifie l'identifiant complet de la seconde offre à comparer (<nom_offre>.service.<vitam_site_name>.consul).
  * Si votre vitam_strategy contient uniquement 2 offres, elles seront automatiquement sélectionnées.
* le paramètre ``tenants`` correspond à la liste des tenants séparés par une virgule.
* Le paramètre ``containers`` correspond à la liste des containers séparés par une virgule selon la liste suivante :

  .. literalinclude:: ./data/container_list.txt

  Si l'audit comparatif des offres remonte des anomalies, les rapports sont mis à disposition sous le répertoire ``environments/offer_diff_reports/<offer1>_<offer2>/<tenantId>_<container>-<timestamp>-<reportFileName>``

* Les journaux de l'audit comparatif se trouvent dans les logs du composant **storage**. Ils peuvent être suivis via la commande suivante:

    .. code-block:: bash

        tail -F /vitam/log/storage/storage_offer_diff.\*.log
