Data Domain: Aktivieren der DD Boost-API-Protokollierung | Vorzertifizierte Protokolle
Summary: In diesem Wissensdatenbank-Artikel wird erläutert, wie Sie die DD Boost-Plug-in-Protokollierung beim Troubleshooting von Problemen im Zusammenhang mit Boost und BoostFS aktivieren. Dies wird als Precert-Protokoll bezeichnet. ...
Instructions
ddboost_precert.ini File ermöglicht eine umfassendere Diagnose. Eine falsche Dateiplatzierung, fehlende Berechtigungen oder eine Fehlkonfiguration können die Erstellung von Protokollen verhindern.
Gründe für die Aktivierung der Protokollierung auf API-Ebene (precert):
- DD Boost- oder BoostFS-Vorgänge schlagen fehl oder verhalten sich unerwartet.
- Die Engineering- oder Support-Abteilung fordert detaillierte Protokolle auf API-Ebene zur Analyse an.
- Es werden trotz erwarteter Boost-Aktivität keine Protokolle erzeugt.
Allgemeine Hinweise:
- Aktivieren Sie die Protokollierung vor der Zertifizierung nur, wenn dies ausdrücklich von der Technikabteilung oder dem Support angefordert wird.
- Überwachen Sie den Speicherplatz genau; Protokolle können schnell anwachsen.
- Stellen Sie sicher, dass Berechtigungen und die richtige Dateiplatzierung korrekt sind.
- Entfernen Sie die
.iniDatei, um die Protokollierung zu deaktivieren. - BoostFS muss ungemountet und erneut gemountet werden, damit die Änderungen wirksam werden.
Dateispeicherorte nach BS
| Betriebssystem | ddboost_precert.ini Standort |
ddboost_precert.log Standort |
|---|---|---|
| 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/BoostFS-Versionen vor 7.0
Erstellen Sie eine leere Datei mit dem Namen ddboost_precert.ini an der entsprechenden Stelle (siehe Tabelle oben). Dadurch wird die Protokollierung im Standardpfad aktiviert.
Für BOOST/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
- Diese Konfiguration erstellt vier Protokolldateien mit jeweils 512 MB (2 GB insgesamt).
- Justieren
num_log_filesundlog_file_sizenach Bedarf. - Protokolle können an einen anderen Speicherort umgeleitet werden, wenn der Speicherplatz begrenzt ist.
Linux BOOSTFS-Client-Setup
- Erstellen
/DDLogVerzeichnis:mkdir /DDLogchmod 777 /DDLog
-
Erstellen
/ddboost_precert.inimit der obigen Konfiguration. -
Stellen Sie sicher, dass BoostFS ungemountet und erneut gemountet ist:
mount -o log-level=debug <mount_point>
Windows BOOSTFS-Client-Setup
- Erstellen
C:\ddboost_precert.inimit 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
-
-
Erstellen
C:\DDLogund weisen Sie vollständige Lese-/Schreibberechtigungen zu. -
Unmounten Sie BoostFS und mounten Sie es erneut mit aktivierter Debug-Protokollierung.
Bereinigen und Deaktivieren der Protokollierung
- Löschen Sie die Datei
ddboost_precert.inizu verwenden. - Löschen Sie die Datei
DDLogVerzeichnis und seinen Inhalt. - Mounten Sie BoostFS erneut, um die Änderungen zu übernehmen.
- Erfassen Sie BoostFS-Protokolle von
/opt/emc/boostfs/log.
Additional Information
Für BOOST/BoostFS-Versionen vor 7.0 werden Vorabzertifikatprotokolle aktiviert, indem eine leere Datei mit dem genauen Namen "ddboost_precert.ini" an dem in der folgenden Tabelle angegebenen Speicherort erstellt wird. Dies führt dazu, dass die DD Boost-SDK-API diese Protokollierung am Standardspeicherort und -dateinamen aktiviert, wie in der folgenden Tabelle gezeigt:
Dieses Tool sollte nur aktiviert werden, wenn dies von den Engineering- oder Supportteams angefordert wird. Aufgrund der Menge der generierten Protokolle sollte darauf geachtet werden, dass diese Protokollierung so bald wie möglich deaktiviert wird.
| Betriebssystem | Dateispeicherort ddboost_precert.ini | Dateispeicherort ddboost_precert.log |
|---|---|---|
| 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 [1] | C:\DDLog\ddboost_precert.log |
Für BOOST und BoostFS 7.0 und spätere Versionen muss die Datei "ddboost_precert.ini" an den gleichen Speicherorten wie oben erstellt werden, aber sie darf nicht leer sein, sie muss mit dem folgenden Inhalt initialisiert werden, andernfalls werden die Protokolle nicht erstellt :
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
Mit den obigen Einstellungen werden 4 Dateien mit jeweils 512 MB erstellt, sodass insgesamt nur 2 GB Speicherplatz benötigt werden.
Wenn 4 Dateien à 512MB nicht den für die Fehlersuche erforderlichen Zeitraum abdecken, passen Sie bitte die Anzahl der Dateien und deren Größe mit den Parametern "num_log_files" und "log_file_size" an.
Mit der angezeigten Konfiguration werden die Protokolle am selben Speicherort wie in der Tabelle erstellt, aber es besteht die Möglichkeit, die Protokolle an einem anderen Speicherort zu erstellen, wenn die Stammpartition des Betriebssystems nicht groß genug ist.
ANMERKUNG: Dieser Ordner muss im selben Pfad wie die ddboost_precert.ini Datei vorhanden sein (bis zur Bestätigung durch jemanden, der es besser weiß, wenn dies wahr ist, würde es unmöglich sein, das Protokoll auf eine andere Partition als die typischerweise kleine root zu schreiben)
Wenn die .ini Datei vorhanden ist (und im Fall von 7.0 oder höher den entsprechenden Inhalt hat), wird eine Protokolldatei mit dem Namen ddboost_precert.log im Ordner /DDLog erzeugt (sofern dieser Pfad konfiguriert ist).
Die ddboost_precert.log kann sehr schnell anwachsen, da alle API-Aufrufe in der Datei protokolliert werden. Achten Sie daher darauf, wie viel Speicherplatz am Clientspeicherort für die Protokolle verfügbar ist, da dies dazu führen kann, dass sich die Partition füllt und dies zu Ausfallzeiten und Unannehmlichkeiten für den Kunden führt.
Um die Protokollierung zu beenden, werden durch Entfernen der Datei ddboost_precert.ini Protokolle in der konfigurierten Datei erstellt, die sofort beendet werden.
Bei anderer Backupsoftware, die ddboost verwendet, ist möglicherweise ein Neustart der Services erforderlich, wenn keine Protokolldatei erstellt wird, um das Vorhandensein oder Fehlen der ddboost_precert.ini Datei zu erkennen
=====================================================================================================
Schritte zum Aktivieren von Vorabzertifikatprotokollen auf Linux BoostFS-Server
1. Erstellen Sie ein Verzeichnis DDLog als /DDLog
2. Erstellen Sie eine Datei ddboost_precert.ini auf / 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
3. Speichern Sie die obigen Inhalte in der Datei ddboost_precert.ini
4. Stellen Sie sicher, dass das Verzeichnis /DDLog über die Schreibberechtigungen verfügt. Geben Sie alle Dateien im Verzeichnis /DDLog an.
a. Ändern Sie die Berechtigungen für DDLog und ddboost_precert.ini
b. führen Sie "sudo chmod 777 DDLog/ ddboost_precert.ini'5
" aus. Erfassen Sie die BoostFS-Protokolle auf Debug-Ebene.
ein. Unmounten Sie den BoostFS-Einhängepunkt und mounten Sie ihn erneut mit der Option "-o log-level=debug"
. b. Sie können die Protokollebene auch in der Datei boostfs.conf im Verzeichnis /opt/emc/boostfs/etc aktualisieren. Sie müssen das BoostFS-Laufwerk
dennoch unmounten.c. Führen Sie den Backupvorgang auf dem BoostFS-Einhängepunkt aus.
d. Geben Sie alle Dateien im Verzeichnis an: /opt/emc/boostfs/log
======================================================================================================
Aktivieren Sie Vorabzertifikatprotokolle auf Windows BoostFS-Server
1. Erstellen Sie ddboost_precert.ini unter C: Laufwerk 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
2. Erstellen Sie einen Ordner mit dem Namen DDLog unter Laufwerk C:. Die Vorabzertifikat-Protokolldateien werden in diesem Ordner erstellt. Geben Sie alle Lese-/Schreibberechtigungen für das DDLog-Verzeichnis an, damit Protokolldateien erstellt und angehängt werden können.
ANMERKUNG:
Die obige Konfiguration erstellt maximal 3 Precert-Protokolldateien mit jeweils ca.
500 MB.Es können unterschiedliche Werte für num_log_files und log_file_size verwendet werden, wenn dies als passend erachtet wird. Aber 3 Dateien mit je 500 MB sollten ausreichen.
Wenn 1,5 GB freier Speicherplatz auf dem Clientsystem nicht möglich sind, kann der Wert von log_file_size auf 200 reduziert werden.
Stellen Sie sicher, dass genügend Speicherplatz auf dem Clientsystem verfügbar ist, bevor Sie Vorabzertifikatprotokolle aktivieren.
3. Unmounten Sie den BoostFS-Einhängepunkt und mounten Sie ihn erneut mit der Option "-o log-level=debug"
.Bereinigungsaktivität und Deaktivieren der Precert-Protokollierung
Sobald die Vorabzertifikatprotokolle nach dem Problem erfasst wurden, deaktivieren Sie die Vorzertifikatprotokollierung mit den folgenden Schritten. Dies muss vor dem erneuten Mounten der BoostFS-SU durchgeführt werden.
1. Löschen Sie den DDLog-Ordner aus C: und seinen Inhalt
2. Löschen Sie ddboost_precert.ini Datei aus C:
=====================================================================================================Aktivieren Sie Vorabzertifikatprotokolle auf einem Linux-Server mit einer ddboost-Backupanwendung.
Verfahren zum Aktivieren der DDBoost-Precert-Protokollierung auf einem Linux-DDBoost-Server:
Erstellen Sie das Verzeichnis /DDLog
2. Erteilen Sie allen Nutzern mit dem folgenden Befehl alle Berechtigungen für das Verzeichnis /DDLog:
$ chmod 777 /DDLog
3. Erstellen Sie eine Datei /ddboost_precert.ini 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
4. Vorzertifizierte Protokolle werden im Verzeichnis /DDLog erzeugt.
=======================================================================================
Aktivieren Sie Vorabzertifikatprotokolle auf Windows Server mit einer ddboost-Backupanwendung.
1. Erstellen Sie ddboost_precert.ini unter C: Laufwerk 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
2. Erstellen Sie einen Ordner mit dem Namen DDLog unter Laufwerk C:. Die Vorabzertifikat-Protokolldateien werden in diesem Ordner erstellt. Geben Sie alle Lese-/Schreibberechtigungen für das DDLog-Verzeichnis an, damit Protokolldateien erstellt und angehängt werden können.
ANMERKUNG:
Die obige Konfiguration erstellt maximal 3 Precert-Protokolldateien mit jeweils ca.
500 MB.Es können unterschiedliche Werte für num_log_files und log_file_size verwendet werden, wenn dies als passend erachtet wird. Aber 3 Dateien mit je 500 MB sollten ausreichen.
Wenn 1,5 GB freier Speicherplatz auf dem Clientsystem nicht möglich sind, kann der Wert von log_file_size auf 200 reduziert werden.
Stellen Sie sicher, dass genügend Speicherplatz auf dem Clientsystem verfügbar ist, bevor Sie Vorabzertifikatprotokolle aktivieren.
Bereinigungsaktivität und Deaktivieren der Precert-Protokollierung
Sobald die Vorabzertifikatprotokolle nach dem Problem erfasst wurden, deaktivieren Sie die Vorabzertifikatprotokollierung mit den folgenden Schritten.
1. Löschen Sie den DDLog-Ordner aus C: und seinen Inhalt
2. Löschen Sie ddboost_precert.ini Datei aus C: