Data Domain : Activation de la journalisation API DD Boost | Journaux Precert

Raisons d’activer la journalisation au niveau de l’API (precert) :

• Les opérations DD Boost ou BoostFS échouent ou se comportent de manière inattendue.
• L’ingénierie ou le support demande des journaux détaillés au niveau de l’API à des fins d’analyse.
• Aucun journal n’est généré malgré l’activité Boost attendue.

Remarques générales :

• N’activez la journalisation precert que si cela est explicitement demandé par l’équipe d’ingénierie ou le support.
• Surveillez de près l’espace disque ; Les journaux peuvent croître rapidement.
• Assurez-vous que les autorisations et le placement des fichiers sont corrects.
• Retirez le .ini pour désactiver la journalisation.
• BoostFS doit être démonté et remonté pour que les modifications prennent effet.

Emplacements des fichiers par système d’exploitation

Pour les versions BOOST/BoostFS antérieures à la version 7.0

Créez un fichier vide nommé ddboost_precert.ini à l’endroit approprié (voir le tableau ci-dessus). Cela permet la journalisation sur le chemin par défaut.

Pour BOOST/BoostFS version 7.0 et versions ultérieures

Création d’un environnement ddboost_precert.ini avec le contenu suivant :

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

• Cette configuration crée quatre fichiers journaux de 512 Mo chacun (2 Go au total).
• Ajuster num_log_files et log_file_size au besoin.
• Les journaux peuvent être redirigés vers un autre emplacement si l’espace disque est limité.

Configuration du client Linux BOOSTFS

1. Création /DDLog répertoire:
   • mkdir /DDLog
chmod 777 /DDLog

2. Création /ddboost_precert.ini avec la configuration ci-dessus.

3. Assurez-vous que BoostFS est démonté et remonté :

   • mount -o log-level=debug <mount_point>

Configuration du client Windows BOOSTFS

1. Création C:\ddboost_precert.ini avec le contenu suivant :

   • precert_enabled=true
     num_log_files=3
     log_file_size=500
     log_file_name=ddboost_precert.log
     log_file_dir=C:\DDLog
     ddcl_logs_include=true
     ddcl_logs_sev=4

2. Création C:\DDLog et attribuez des autorisations complètes en lecture/écriture.

3. Démontez et remontez BoostFS avec la journalisation de débogage activée.

Nettoyage et désactivation de la journalisation

1. Supprimez le ddboost_precert.ini .
2. Supprimez le DDLog et son contenu.
3. Remontez BoostFS pour appliquer les modifications.
4. Collecter les logs BoostFS à partir de /opt/emc/boostfs/log.

Pour les versions BOOST/BoostFS antérieures à la version 7.0, les journaux precert sont activés en créant un fichier vide nommé exactement « ddboost_precert.ini » à l’emplacement indiqué dans le tableau ci-dessous. Dans ce cas, l’API DD Boost SDK activera cette journalisation à l’emplacement et au nom de fichier par défaut, comme indiqué dans le tableau ci-dessous : 

Cet outil ne doit être activé que lorsque l’équipe d’ingénierie ou de support le demande et, en raison de la quantité de journaux générés, il est conseillé de désactiver cette journalisation dès que possible.

 

Pour BOOST et BoostFS 7.0 et versions ultérieures, le fichier « ddboost_precert.ini » doit être créé aux mêmes emplacements que ci-dessus, mais il ne peut pas être vide, il doit être initialisé avec le contenu ci-dessous, sinon les journaux ne seront pas créés :
precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4



Avec les paramètres ci-dessus, il créera 4 fichiers de 512 Mo chacun, donc au total, il ne prendra que 2 Go d’espace disque.

Si 4 fichiers de 512 Mo chacun n’ont pas couvert la période requise pour le dépannage, veuillez ajuster la quantité de fichiers et leur taille à l’aide des paramètres « num_log_files » et « log_file_size ».

Avec la configuration affichée, les journaux sont créés au même emplacement que dans le tableau, mais il est possible de créer les journaux à un emplacement différent si la partition racine du système d’exploitation n’est pas suffisante.

NOTE: Ce dossier doit être présent dans le même chemin que le fichier ddboost_precert.ini (en attendant la confirmation par quelqu’un qui s’y connaît, si cela est vrai, il serait impossible d’écrire le journal sur une partition autre que la racine généralement petite)