Data Domain : Activation de la journalisation de l’API DD Boost - Journaux Precert

Summary: Cet article explique comment activer la journalisation des plug-ins Data Domain Boost (DD Boost) lors du dépannage des problèmes liés à Boost et BoostFS. C’est ce qu’on appelle un journal precert. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Remarque : Par défaut, le plug-in DD Boost ne consigne pas l’activité détaillée de l’API. Activation de la journalisation precert à l’aide de ddboost_precert.ini Le mode fichier permet d’effectuer des diagnostics plus approfondis. Un placement incorrect des fichiers, des autorisations manquantes ou une mauvaise configuration peuvent empêcher la génération des logs.

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 consignation :
  • BoostFS doit être démonté et remonté pour que les modifications prennent effet.

Emplacements des fichiers par système d’exploitation

Système d’exploitation ddboost_precert.ini Location ddboost_precert.log Location
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini C:\DDLog\ddboost_precert.log

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

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


Pour BOOST et 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).
  • Possibilités de réglage num_log_files et log_file_size selon les besoins.
  • Les journaux peuvent être redirigés vers un autre emplacement si l’espace disque est limité.

Configuration du client Linux BOOSTFS

  1. Créer /DDLog répertoire :

mkdir /DDLog

chmod 777 /DDLog

  1. Créer /ddboost_precert.ini avec la configuration ci-dessus.

 

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

mount -o log-level=debug <mount_point>

 


Configuration du client Windows BOOSTFS

  1. Créer 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
  1. Créer C:\DDLog et attribuez des autorisations complètes en lecture/écriture.
  2. Démontage et remontage BoostFS avec journalisation de débogage activée.

Nettoyage et désactivation de la journalisation

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

Additional Information

Forum aux questions

    Question : Qu’est-ce que la journalisation DD Boost Precert ? La journalisation DD Boost Precert est une fonction de journalisation de diagnostic qui enregistre les transactions de l’API DD Boost entre un client DD Boost et le système Data Domain.
    Réponse : Il est couramment utilisé pour résoudre les problèmes de performances, les défaillances, la latence et les problèmes de communication.

    Question : Qu’est-ce que Precert Logging capture ? La journalisation avant certification capture l’activité de l’API DD Boost, y compris les opérations de lecture, les opérations d’écriture, l’activité de sauvegarde, l’activité de restauration, les interactions de la bibliothèque DD Boost, les informations de synchronisation des appels d’API et les indicateurs de latence côté client.
    Réponse : Elle fournit une visibilité détaillée sur le comportement de l’API DD Boost à des fins de dépannage et d’analyse des performances.

    Question : Pourquoi aucun journal precert n’est-il généré ? Vérifiez que le fichier ddboost_precert.ini existe, qu’il se trouve à la racine du système d’exploitation, que le répertoire des fichiers log existe, que le répertoire des journaux est accessible en écriture et qu’une nouvelle opération de sauvegarde ou de restauration a démarré.
    Réponse : Une configuration manquante, un placement incorrect, des problèmes d’autorisation ou l’absence de nouvelle activité DD Boost sont les causes les plus courantes.

    Question : L’activation de la journalisation precert génère-t-elle immédiatement des journaux ? La configuration active uniquement la fonctionnalité de journalisation.
    Réponse : Non, les fichiers journaux sont générés uniquement lorsque de nouvelles demandes d’API DD Boost sont reçues.

    Question : Pourquoi ma sauvegarde en cours d’exécution ne génère-t-elle pas de journaux precert ? La journalisation Precert capture uniquement l’activité de l’API initiée après la détection de la configuration.
    Réponse : Les procédures de sauvegarde ou de restauration existantes se poursuivent sans générer de logs de précert.

    Question : Dois-je redémarrer ma tâche de sauvegarde ou de restauration ? Si la tâche était déjà en cours d’exécution lorsque la journalisation a été activée, démarrez une nouvelle opération.
    Réponse : Oui, une nouvelle procédure de sauvegarde ou de restauration est requise pour générer des logs de précertage.

    Question : Quelle est la raison la plus courante pour laquelle la journalisation precert ne fonctionne pas ? Les causes les plus courantes sont les suivantes : ddboost_precert.ini ne pas être au niveau de la racine, être nommé accidentellement ddboost_precert.ini.txt, un répertoire de journaux manquant ou des autorisations insuffisantes.
    Réponse : Les problèmes de configuration et de système de fichiers sont les causes les plus fréquentes.

    Question : Où le fichier ddboost_precert.ini doit-il être placé ? 

    Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.

    Réponse : Le fichier doit résider dans le répertoire racine du système d’exploitation.

    Question : Le fichier ddboost_precert.ini peut-il être stocké dans un autre dossier ? Le plugin DD Boost vérifie uniquement le répertoire racine du système d’exploitation.
    Réponse : Non, le fichier doit être stocké à la racine.

    Question : Comment puis-je vérifier que le fichier n’est pas

    ddboost_precert.ini.txt

    Ouvrez l’Explorateur de fichiers, activez les extensions de nom de fichier et vérifiez le nom de fichier.
    Réponse : Assurez-vous que le fichier porte un nom 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Question : Pourquoi est-ce que le DDLog Répertoire vide après activation de la journalisation ? Les causes possibles incluent l’absence de nouvelle activité DD Boost, des problèmes d’autorisation ou un fichier de configuration qui n’a pas été détecté.
    Réponse : Exécutez une nouvelle sauvegarde, restauration ou DDPCONNCHK Testez pour générer de l’activité.

    Question : Qu’est-ce que DDPCONNCHK Et pourquoi est-ce utile ? DDPCONNCHK est un outil de validation de connectivité DD Boost.
    Réponse : Il peut générer une activité de l’API DD Boost et confirmer rapidement que la journalisation precert fonctionne.

    Question : Est-ce que DDPCONNCHK pour tester ma configuration ? Les ingénieurs exécutent fréquemment DDPCONNCHK Après activation de la journalisation.
    Réponse : Oui, il s’agit d’un moyen courant de vérifier que les journaux sont générés avant de reproduire un problème.

    Question : Pourquoi mes journaux precert augmentent-ils si rapidement ? La journalisation Precert enregistre chaque appel d’API DD Boost.
    Réponse : Les environnements de sauvegarde volumineux peuvent générer un volume de logs important en peu de temps.

    Question : Quelle quantité d’espace disque dois-je allouer ? Une recommandation courante est la suivante : 

    num_log_files=3 and log_file_size=500.

    Réponse : Cela fournit environ 1,5 Go de stockage de fichiers log avant que la rotation ne se produise.

    Question : Les logs precert peuvent-ils remplir un système de fichiers ? La journalisation peut consommer beaucoup d’espace disque si elle n’est pas surveillée.
    Réponse : Oui, les systèmes de fichiers pleins peuvent entraîner des échecs de sauvegarde, des pannes et des interruptions de service.

    Question : Quel est l’objectif de num_log_files ? Ce paramètre contrôle le nombre de fichiers log de rotation conservés.
    Réponse : Par exemple :, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Question : Quel est l’objectif de log_file_size ? Ce paramètre définit la taille maximale de chaque fichier log en Mo.
    Réponse : Par exemple, log_file_size=500 permet à chaque fichier d’atteindre 500 Mo avant la rotation.

    Question : Qu’est-ce qu’une biches ddcl_logs_include=true À faire : Active les informations de journalisation de DD Boost Client Library dans les logs precert.
    Réponse : Le paramètre recommandé est ddcl_logs_include=true.

    Question : Qu’est-ce que ddcl_logs_sev=4 Signification Ce paramètre contrôle la gravité de la journalisation.
    Réponse : Le niveau de gravité 4 fournit des informations détaillées de dépannage et de débogage.

    Question : Dois-je BoostFS Journalisation du débogage en plus de la journalisation precert ? Une journalisation supplémentaire n’est pas toujours nécessaire.
    Réponse : Par exemple, BoostFS-specific L’activation des deux fournit souvent une image diagnostique plus complète.

    Question : Par exemple, BoostFS, dois-je le démonter et le remonter ? Le démontage et le remontage réinitialisent l’activité BoostFS.
    Réponse : Dans de nombreux cas, oui, cela permet de lancer une nouvelle activité DD Boost.

    Question : Quelle est la syntaxe correcte de journalisation de débogage BoostFS ? La syntaxe correcte est : -o log-level=debug.
    Réponse : Ne pas utiliser --o log-level=debug car un seul tiret est valide.

    Question : Pourquoi le remontage de BoostFS entraîne-t-il soudainement l’affichage des logs de précert ? Le remontage crée un nouveau cycle d’initialisation pour BoostFS.
    Réponse : La journalisation commence lorsque la nouvelle activité de l’API DD Boost se produit et que le plugin détecte le fichier de configuration.

    Question : Le redémarrage d’une application équivaut-il au remontage de BoostFS ? Toute action qui crée une nouvelle activité d’API DD Boost peut déclencher la journalisation.
    Réponse : Généralement oui, par exemple, le redémarrage RMAN, un logiciel de sauvegarde ou en cours d’exécution DDPCONNCHK.

    Question : Est-ce que RMAN générer des logs precert sans démonter BoostFS ? RMAN peut lancer directement de nouvelles demandes d’API DD Boost.
    Réponse : Oui, le démarrage d’un nouveau RMAN l’opération est normalement suffisante.

    Question : Comment désactiver la journalisation precert ? Supprimez ddboost_precert.ini ou renommez-le en ddboost_precert.ini.disabled.
    Réponse : La journalisation n’est activée que lorsque le nom de fichier exact ddboost_precert.ini Existing :

    Question : Dois-je redémarrer l’hôte après avoir supprimé le fichier ini ? Le plugin vérifie le fichier de configuration lors d’opérations ultérieures.
    Réponse : Non, aucun redémarrage n’est nécessaire.

    Question : Quelles autorisations doivent être utilisées sur Linux ? Exemples d’autorisations : 

    mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.

    Réponse : Le processus DD Boost doit être en mesure de lire le fichier de configuration et de l’écrire dans le répertoire des logs.

    Question : Où les logs BoostFS sont-ils stockés par défaut ? 

    Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.

    Réponse : Ces emplacements sont distincts des journaux precert DD Boost.

    Question : Les logs BoostFS et les logs precert sont-ils la même chose ? Les logs BoostFS contiennent l’activité de montage, les opérations du système de fichiers et les événements d’application.
    Réponse : Non, les logs precert contiennent les transactions de l’API DD Boost, les communications de bibliothèque et les données de synchronisation des E/S.

    Question : Quels journaux dois-je fournir au support ? En fonction du problème, collectez les ddboost_precert.log, les journaux de précert rotatifs, les logs BoostFS, DDPCONNCHK sortie, journaux d’application et bundles de support demandés.
    Réponse : L’envoi de tous les journaux pertinents permet d’accélérer le dépannage.

    Question : Que dois-je faire si les journaux ne sont toujours pas générés après avoir suivi cet article de la base de connaissances ? Collectez des preuves telles que l’emplacement du ddboost_precert.ini, la liste des répertoires de journaux, DDPCONNCHK sortie, la commande de montage BoostFS et les informations sur les autorisations.
    Réponse : Envoyez les informations collectées au support technique Dell pour une analyse plus approfondie.

    Affected Products

    Data Domain

    Products

    Data Domain
    Article Properties
    Article Number: 000020437
    Article Type: How To
    Last Modified: 21 Aug 2026
    Version:  9
    Find answers to your questions from other Dell users
    Support Services
    Check if your device is covered by Support Services.