Data Domain: Aktivieren der DD Boost-API-Protokollierung – Precert-Protokolle

Summary: In diesem Artikel wird erläutert, wie Sie die Data Domain Boost(DD Boost)-Plug-in-Protokollierung beim Troubleshooting von Problemen im Zusammenhang mit Boost und BoostFS aktivieren. Dies wird als Vorabzertifikatprotokoll bezeichnet. ...

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.
Check out other resources

Instructions

Hinweis: Das DD Boost-Plug-in protokolliert standardmäßig keine detaillierte API-Aktivität. Aktivieren der Vorabzertifikatprotokollierung mithilfe der ddboost_precert.ini File ermöglicht eine umfassendere Diagnose. Eine falsche Dateiplatzierung, fehlende Berechtigungen oder Fehlkonfigurationen können die Protokollerstellung verhindern.

Gründe für die Aktivierung der Protokollierung auf API-Ebene (Vorabzertifizierung):

  • DD Boost- oder BoostFS-Vorgänge schlagen fehl oder verhalten sich unerwartet.
  • Ingenieure und Techniker oder der Support fordern detaillierte Protokolle auf API-Ebene zur Analyse an.
  • Trotz erwarteter Boost-Aktivität werden keine Protokolle erzeugt.

Allgemeine Hinweise

  • Aktivieren Sie die Vorabprotokollierung nur, wenn dies vom Engineering oder Support ausdrücklich gefordert wurde.
  • Überwachen Sie den Speicherplatz genau. Protokolle können schnell wachsen.
  • Stellen Sie sicher, dass die Berechtigungen und die Dateiplatzierung korrekt sind.
  • Entfernen Sie den .ini So deaktivieren Sie die Protokollierung:
  • BoostFS muss ungemountet und erneut gemountet werden, damit Änderungen wirksam werden.

Dateispeicherorte nach Betriebssystem

Betriebssystem ddboost_precert.ini Position ddboost_precert.log Position
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

Für BOOST- und BoostFS-Versionen vor 7.0

Leere Datei erstellen ddboost_precert.ini an der entsprechenden Stelle (siehe Tabelle oben). Dies ermöglicht die Protokollierung auf dem Standardpfad.

Für BOOST und BoostFS Version 7.0 und höher

Erstellen einer konfigurierten ddboost_precert.ini Datei mit folgendem Inhalt:

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
  • Bei dieser Konfiguration werden vier Protokolldateien mit jeweils 512 MB (insgesamt 2 GB) erstellt.
  • Verstellbarkeit num_log_files und log_file_size nach Bedarf.
  • Protokolle können an einen anderen Speicherort umgeleitet werden, wenn der Speicherplatz begrenzt ist.

BOOSTFS-Client für Linux – Setup

  1. Erstellen /DDLog Verzeichnis:

mkdir /DDLog

chmod 777 /DDLog

  1. Erstellen /ddboost_precert.ini mit der obigen Konfiguration.

 

  1. Stellen Sie sicher, dass BoostFS wird ungemountet und erneut gemountet:

mount -o log-level=debug <mount_point>

 

Einrichtung des Windows BOOSTFS-Clients

  1. Erstellen C:\ddboost_precert.ini mit folgendem Inhalt:
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. Erstellen C:\DDLog und weisen Sie vollständige Lese-/Schreibberechtigungen zu.
  2. Unmounten und erneutes Mounten BoostFS mit aktivierter Debug-Protokollierung.

Bereinigung und Deaktivierung der Protokollierung

  1. Löschen Sie die ddboost_precert.ini Datei.
  2. Löschen Sie die DDLog Verzeichnis und seine Inhalte.
  3. Mounten Sie BoostFS erneut, um die Änderungen zu übernehmen.
  4. BoostFS-Protokolle sammeln von /opt/emc/boostfs/log.

Additional Information

Häufig gestellte Fragen (FAQs)

    Frage: Was ist DD Boost Precert Logging? DD Boost Precert Logging ist eine Diagnoseprotokollierungsfunktion, die DD Boost-API-Transaktionen zwischen einem DD Boost-Client und dem Data Domain-System aufzeichnet.
    Antwort: Es wird häufig für das Troubleshooting von Leistungsproblemen, Ausfällen, Latenz und Kommunikationsproblemen verwendet.

    Frage: Was wird von der Precert-Protokollierung erfasst? Die Vorabprotokollierung erfasst DD Boost-API-Aktivitäten, einschließlich Lesevorgänge, Schreibvorgänge, Backupaktivitäten, Wiederherstellungsaktivitäten, DD Boost-Bibliotheksinteraktionen, Zeitangaben zu API-Aufrufen und clientseitige Latenzindikatoren.
    Antwort: Sie bietet detaillierte Einblicke in das Verhalten der DD Boost-API für Troubleshooting und Performanceanalysen.

    Frage: Warum werden keine Vorabzertifikatsprotokolle erzeugt? Überprüfen Sie, ob die ddboost_precert.ini Datei vorhanden ist, sich im Stammverzeichnis des Betriebssystems befindet, das Protokollverzeichnis vorhanden ist, das Protokollverzeichnis beschreibbar ist und ein neuer Backup- oder Wiederherstellungsvorgang gestartet wurde.
    Antwort: Fehlende Konfiguration, falsche Platzierung, Berechtigungsprobleme oder fehlende neue DD Boost-Aktivitäten sind die häufigsten Ursachen.

    Frage: Werden durch die Aktivierung der Vorabzertifikatsprotokollierung sofort Protokolle erzeugt? Die Konfiguration aktiviert nur die Protokollierungsfunktion.
    Antwort: Nein, Protokolldateien werden nur erzeugt, wenn neue DD Boost-API-Anforderungen eingehen.

    Frage: Warum erzeugt mein derzeit laufendes Backup keine Vorabzertifikatsprotokolle? Die Vorabzertifikatsprotokollierung erfasst nur API-Aktivitäten, die initiiert werden, nachdem die Konfiguration erkannt wurde.
    Antwort: Vorhandene Backup- oder Wiederherstellungsjobs werden fortgesetzt, ohne Vorabzertifikatsprotokolle zu erzeugen.

    Frage: Muss ich meinen Backup- oder Wiederherstellungsjob neu starten? Wenn der Job bereits ausgeführt wurde, als die Protokollierung aktiviert wurde, starten Sie einen neuen Vorgang.
    Antwort: Ja, ein neuer Backup- oder Wiederherstellungsjob ist erforderlich, um Vorabzertifikatsprotokolle zu erzeugen.

    Frage: Was ist der häufigste Grund, warum die Vorabzertifikatprotokollierung nicht funktioniert? Häufige Ursachen sind ddboost_precert.ini Nicht auf Root-Ebene, versehentlich benannt ddboost_precert.ini.txt, ein fehlendes Protokollverzeichnis oder unzureichende Berechtigungen.
    Antwort: Konfigurations- und Dateisystemprobleme sind die häufigsten Ursachen.

    Frage: Wo soll die ddboost_precert.ini Datei abgelegt werden? 

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

    Antwort: Die Datei muss sich im Stammverzeichnis des Betriebssystems befinden.

    Frage: Kann die ddboost_precert.ini Datei in einem anderen Ordner gespeichert werden? Das DD Boost-Plug-in überprüft nur das Stammverzeichnis des Betriebssystems.
    Antwort: Nein, die Datei muss im Stammverzeichnis gespeichert werden.

    Frage: Wie kann ich überprüfen, ob die Datei nicht tatsächlich 

    ddboost_precert.ini.txt

    Öffnen Sie den Datei-Explorer, aktivieren Sie Dateinamenerweiterungen und überprüfen Sie den Dateinamen.
    Antwort: Stellen Sie sicher, dass die Datei mit dem Namen 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Frage: Warum ist der DDLog Verzeichnis nach Aktivierung der Protokollierung leer? Mögliche Ursachen sind: keine neue DD Boost-Aktivität, Berechtigungsprobleme oder eine Konfigurationsdatei, die nicht erkannt wurde.
    Antwort: Führen Sie ein neues Backup oder eine Wiederherstellung durch oder DDPCONNCHK Führen Sie einen Test durch, um eine Aktivität zu generieren.

    Frage: Was ist DDPCONNCHK Und warum ist es nützlich? DDPCONNCHK ist ein DD Boost-Konnektivitätsvalidierungstool.
    Antwort: Dies kann DD Boost-API-Aktivitäten erzeugen und schnell bestätigen, dass die Vorabzertifikatprotokollierung funktioniert.

    Frage: Kann DDPCONNCHK zum Testen meiner Konfiguration verwendet werden? IngenieurInnen und TechnikerInnen führen häufig DDPCONNCHK Nach dem Aktivieren der Protokollierung.
    Antwort: Ja, dies ist eine gängige Methode, um zu überprüfen, ob Protokolle erzeugt werden, bevor ein Problem reproduziert wird.

    Frage: Warum wachsen meine Vorabzertifikatsprotokolle so schnell? Die Vorabzertifikatsprotokollierung zeichnet jeden DD Boost-API-Aufruf auf.
    Antwort: In großen Backupumgebungen kann innerhalb kurzer Zeit ein erhebliches Protokollvolumen generiert werden.

    Frage: Wie viel Speicherplatz sollte ich zuweisen? Eine gängige Empfehlung ist 

    num_log_files=3 and log_file_size=500.

    Antwort: Dies bietet etwa 1,5 GB Protokollspeicher, bevor die Rotation stattfindet.

    Frage: Können Vorabzertifikatsprotokolle ein Dateisystem füllen? Die Protokollierung kann erhebliche Speicherplatzbeanspruchungen in Anspruch nehmen, wenn sie nicht überwacht wird.
    Antwort: Ja, vollständige Dateisysteme können zu Backupfehlern, Ausfällen und Serviceunterbrechungen führen.

    Frage: Was ist der Zweck von num_log_files? Dieser Parameter steuert die Anzahl der aufbewahrten rotierten Protokolldateien.
    Antwort: Zum Beispiel, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Frage: Was ist der Zweck von log_file_size? Dieser Parameter definiert die maximale Größe jeder Protokolldatei in MB.
    Antwort: Beispiel: Bei log_file_size=500 kann jede Datei vor der Rotation auf 500 MB anwachsen.

    Frage: Was tun sie?s ddcl_logs_include=true Erlaubt“ Sie ermöglicht die Protokollierung von DD Boost-Clientbibliotheksinformationen in den Vorabzertifikatprotokollen.
    Antwort: Die empfohlene Einstellung ist ddcl_logs_include=true.

    Frage: Was bedeutet ddcl_logs_sev=4 Bedeutung Dieser Parameter steuert den Protokollierungsschweregrad.
    Antwort: Schweregrad 4 enthält detaillierte Informationen zum Troubleshooting und Debugging.

    Frage: Brauche ich? BoostFS Debug-Protokollierung zusätzlich zur Vorabzertifikat-Protokollierung? Eine zusätzliche Protokollierung ist nicht immer erforderlich.
    Antwort: Für BoostFS-specific Probleme, bei denen beide aktiviert werden, ergibt sich oft ein vollständigeres diagnostisches Bild.

    Frage: Für BoostFSMuss ich ein Unmounten und erneutes Mounten durchführen? Durch das Unmounten und erneute Mounten wird die BoostFS-Aktivität neu initialisiert.
    Antwort: In vielen Fällen hilft dies, neue DD Boost-Aktivitäten zu initiieren.

    Frage: Wie lautet die korrekte BoostFS-Debug-Protokollierungssyntax? Die richtige Syntax lautet -o log-level=debug.
    Antwort: Nicht verwenden --o log-level=debug denn nur ein einziger Bindestrich ist gültig.

    Frage: Warum wurden beim erneuten Mounten von BoostFS plötzlich Precert-Protokolle angezeigt? Durch das erneute Mounten wird ein neuer Initialisierungszyklus für BoostFS erstellt.
    Antwort: Die Protokollierung beginnt, wenn eine neue DD Boost-API-Aktivität auftritt und das Plug-in die Konfigurationsdatei erkennt.

    Frage: Entspricht der Neustart einer Anwendung dem erneuten Mounten von BoostFS? Jede Aktion, die neue DD Boost-API-Aktivitäten erstellt, kann eine Protokollierung auslösen.
    Antwort: In der Regel ja, zum Beispiel ein Neustart. RMAN, Backupsoftware oder Ausführung DDPCONNCHK.

    Frage: Kann RMAN Vorabzertifikatprotokolle ohne Unmounten von BoostFS generieren? RMAN kann neue DD Boost-API-Anfragen direkt initiieren.
    Antwort: Ja, ein neues RMAN In der Regel ist der Betrieb ausreichend.

    Frage: Wie deaktiviere ich die Vorabprotokollierung? Löschen Sie ddboost_precert.ini oder benennen Sie sie in ddboost_precert.ini.disabled um.
    Antwort: Die Protokollierung wird nur aktiviert, wenn der genaue Dateiname ddboost_precert.ini Existing:

    Frage: Muss ich den Host nach dem Entfernen der INI-Datei neu starten? Das Plug-in prüft bei zukünftigen Vorgängen auf die Konfigurationsdatei.
    Antwort: Nein, ein Neustart ist nicht erforderlich.

    Frage: Welche Berechtigungen sollten unter Linux verwendet werden? Beispielberechtigungen umfassen 

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

    Antwort: Der DD Boost-Prozess muss in der Lage sein, die Konfigurationsdatei zu lesen und in das Protokollverzeichnis zu schreiben.

    Frage: Wo werden BoostFS-Protokolle standardmäßig gespeichert? 

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

    Antwort: Diese Speicherorte sind von den DD Boost-Vorabzertifikatprotokollen getrennt.

    Frage: Sind BoostFS-Protokolle und Vorabzertifikatsprotokolle identisch? BoostFS-Protokolle enthalten Mount-Aktivitäten, Dateisystemvorgänge und Anwendungsereignisse.
    Antwort: Nein, Vorabzertifikatprotokolle enthalten DD Boost-API-Transaktionen, Bibliothekskommunikation und I/O-Timingdaten.

    Frage: Welche Protokolle sollte ich dem Support zur Verfügung stellen? Erfassen Sie je nach Problem ddboost_precert.log, rotierte Vorabzertifikatprotokolle, BoostFS-Protokolle, DDPCONNCHK Ausgabe, Anwendungsprotokolle und angeforderte Support-Bundles.
    Antwort: Die Bereitstellung aller relevanten Protokolle trägt dazu bei, das Troubleshooting zu beschleunigen.

    Frage: Was soll ich tun, wenn die Protokolle nach dem Befolgen dieses Wissensdatenbank-Artikels immer noch nicht erzeugt werden? Erfassen Sie Nachweise wie den ddboost_precert.ini Speicherort, die Protokollverzeichnisauflistung, DDPCONNCHK Ausgabe, BoostFS-Mount-Befehl und Berechtigungsinformationen.
    Antwort: Senden Sie die gesammelten Informationen zur weiteren Analyse an den technischen Support von Dell.

    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.