Data Domain: DD Boost API-logging inschakelen | Precert-logboeken

Summary: In dit knowledge base-artikel wordt uitgelegd hoe u de DD Boost plug-in logging kunt inschakelen bij het oplossen van problemen met betrekking tot Boost en BoostFS. Dit wordt een precert-logboek genoemd. ...

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

Opmerking: De DD Boost-plug-in registreert standaard geen gedetailleerde API-activiteit. Precert-logging inschakelen met behulp van de ddboost_precert.ini Bestand maakt diepere diagnostiek mogelijk. Onjuiste bestandsplaatsing, ontbrekende machtigingen of verkeerde configuratie kunnen voorkomen dat logboeken worden gegenereerd.

Redenen om logboekregistratie op API-niveau (precert) in te schakelen:

  • DD Boost- of BoostFS-bewerkingen mislukken of gedragen zich onverwacht.
  • Engineering of Support vraagt gedetailleerde logboeken op API-niveau aan voor analyse.
  • Er worden geen logboeken gegenereerd ondanks de verwachte Boost-activiteit.

Algemene opmerkingen:

  • Schakel precert-logging alleen in als Engineering of Support hier expliciet om vraagt.
  • Houd de schijfruimte nauwlettend in de gaten; Boomstammen kunnen snel groeien.
  • Zorg voor de juiste machtigingen en plaatsing van bestanden.
  • Verwijder de .ini Bestand om logboekregistratie uit te schakelen.
  • BoostFS moet worden losgekoppeld en opnieuw worden gekoppeld om wijzigingen door te voeren.

Bestandslocaties per besturingssysteem

Besturingssysteem ddboost_precert.ini Locatie ddboost_precert.log Locatie
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

Voor BOOST/BoostFS-versies ouder dan 7.0

Maak een leeg bestand met de naam ddboost_precert.ini op de juiste locatie (zie bovenstaande tabel). Hiermee kunt u inloggen op het standaardpad.


Voor BOOST/BoostFS versie 7.0 en hoger

Maak een geconfigureerde ddboost_precert.ini bestand met de volgende inhoud:

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
  • Deze configuratie maakt vier logbestanden van elk 512 MB (2 GB in totaal).
  • Aanpassen num_log_files als log_file_size indien nodig.
  • Logboeken kunnen worden omgeleid naar een andere locatie als de schijfruimte beperkt is.

Linux BOOSTFS-client instellen

  1. Maken /DDLog map:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Maken /ddboost_precert.ini met de bovenstaande configuratie.

  3. Zorg ervoor dat BoostFS is ontkoppeld en opnieuw is gekoppeld:

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

Windows BOOSTFS-clientinstellingen

  1. Maken C:\ddboost_precert.ini met de volgende inhoud:
    • 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. Maken C:\DDLog en wijs volledige lees-/schrijfmachtigingen toe.

  3. Ontkoppel BoostFS en koppel deze opnieuw met ingeschakelde logboekregistratie voor foutopsporing.


Logboekregistratie opschonen en uitschakelen

  1. Verwijder de ddboost_precert.ini bestand.
  2. Verwijder de DDLog directory en de inhoud ervan.
  3. Koppel BoostFS opnieuw om wijzigingen toe te passen.
  4. BoostFS logboeken verzamelen van /opt/emc/boostfs/log.

Additional Information

Voor BOOST-/BoostFS-versies ouder dan 7.0 worden precert-logboeken ingeschakeld door een leeg bestand met de exacte naam "ddboost_precert.ini" te maken op de locatie die wordt aangegeven in de onderstaande tabel. Als u dit doet, schakelt de DD Boost SDK API deze logboekregistratie in op de standaardlocatie en bestandsnaam, zoals weergegeven in de onderstaande tabel: 

Deze tool moet alleen worden ingeschakeld wanneer de engineering- of supportteams hierom vragen. Vanwege de hoeveelheid gegenereerde logboeken moet ervoor worden gezorgd dat deze logboekregistratie zo snel mogelijk wordt uitgeschakeld.

 

Besturingssysteem Bestandslocatie ddboost_precert.ini Bestandslocatie 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


Voor BOOST en BoostFS 7.0 en latere releases moet het bestand "ddboost_precert.ini" worden gemaakt op dezelfde locaties als hierboven, maar het mag niet leeg zijn, het moet worden geïnitialiseerd met de onderstaande inhoud, anders worden de logboeken niet gemaakt :
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



Met de bovenstaande instellingen maakt het 4 bestanden van elk 512 MB, dus in totaal neemt het slechts 2 GB schijfruimte in beslag.

Als 4 bestanden van elk 512 MB niet het vereiste tijdsbestek voor probleemoplossing hebben gedekt, pas dan het aantal bestanden en de grootte ervan aan met behulp van de parameters "num_log_files" en "log_file_size".

Als de configuratie wordt weergegeven, worden de logboeken op dezelfde locatie gemaakt als in de tabel, maar er is de optie om de logboeken op een andere locatie te maken als de hoofdpartitie van het besturingssysteem niet groot genoeg is.

NOTITIE: Deze map moet aanwezig zijn in hetzelfde pad als het ddboost_precert.ini bestand (in afwachting van bevestiging door iemand die het beter weet, als dit waar is, zou het onmogelijk zijn om het logbestand naar een andere partitie te schrijven dan de meestal kleine root) 


Wanneer het .ini-bestand aanwezig is (en in het geval van 7.0 of hoger de juiste inhoud heeft), wordt een logboekbestand met de naam ddboost_precert.log gegenereerd in de map /DDLog (als dit pad is geconfigureerd).

De ddboost_precert.log kan zeer snel groeien omdat alle API-aanroepen naar het bestand worden gelogd, dus let op de hoeveelheid beschikbare ruimte op de clientlocatie voor de logboeken, omdat deze ervoor kunnen zorgen dat de partitie vol raakt en resulteert in downtime en ongemak voor de klant.

Als u de logboekregistratie wilt stoppen, stopt het verwijderen van het bestand ddboost_precert.ini de logboeken van het geconfigureerde bestand onmiddellijk stopt.
 
Voor elke wijziging in het ddboost_precert.ini-bestand moet de BOOSTFS worden ontkoppeld en vervolgens opnieuw worden gekoppeld om de wijzigingen door te voeren.
Voor andere back-upsoftware die ddboost gebruikt, kan het nodig zijn de services opnieuw op te starten als er geen logbestand wordt gemaakt om de aan- of afwezigheid van het ddboost_precert.ini bestand te detecteren
 
[1] Het ddboost_precert.ini bestand moet in de hoofdmap van de installatiemap worden geplaatst.  Het kan worden genoemd: D:\ enz.   Als u het bestand op een andere schijf plaatst en er geen logbestand wordt gemaakt, probeer dan toch C:\.

=====================================================================================================

Stappen voor het inschakelen van precert-logboeken op de Linux BoostFS Server

1. Maak een directory DDLog als /DDLog

2. Maak een bestand ddboost_precert.ini op/pad met de volgende inhoud
 
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. Sla de bovenstaande inhoud op in het bestand - ddboost_precert.ini

4. Zorg ervoor dat de map /DDLog schrijfmachtigingen heeft. Geef alle bestanden in de /DDLog-directory op.

a. wijzig machtigingen voor zowel DDLog als ddboost_precert.ini
b. voer 'sudo chmod 777 DDLog/ ddboost_precert.ini'5

uit. Verzamel de BoostFS-logboeken op foutopsporingsniveau.

een. Ontkoppel het BoostFS koppelpunt en monteer het opnieuw met de optie '-o log-level=debug'
b. U kunt ook het logboekniveau bijwerken in het bestand boostfs.conf in de map /opt/emc/boostfs/etc. U moet de BoostFS-schijf nog steeds ontkoppelen/ontkoppelen.
c. Voer de back-upbewerking uit op het BoostFS-koppelpunt.
d. Geef alle bestanden op in de directory - /opt/emc/boostfs/log


======================================================================================================

Precert-logboeken inschakelen op Windows BoostFS Server

1. Maak ddboost_precert.ini onder C:  schijf met de volgende inhoud:

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. Maak een map met de naam DDLog onder station C:. De precert-logbestanden worden in deze map gemaakt. Geef alle lees-/schrijfmachtigingen op voor de DDLog-directory, zodat logbestanden kunnen worden gemaakt en toegevoegd.


NOTITIE:
De bovenstaande configuratie maakt maximaal 3 precert-logbestanden van elk ongeveer 500 MB.
Er kunnen verschillende waarden worden gebruikt voor num_log_files en log_file_size naar eigen goeddunken.  Maar 3 bestanden van elk 500 MB zouden voldoende moeten zijn voor het doel.
Als 1,5 GB vrije ruimte niet mogelijk is op het clientsysteem, kan de waarde van log_file_size worden verlaagd naar 200.
Zorg ervoor dat er voldoende schijfruimte beschikbaar is op het clientsysteem voordat u precertlogboeken inschakelt.

3. Ontkoppel het BoostFS koppelpunt en monteer het opnieuw met de optie '-o log-level=debug'

 
Opschoonactiviteit en uitschakelen van precert-logboekregistratie

Zodra precert-logboeken zijn verzameld na het probleem, schakelt u de precert-logboekregistratie uit met de volgende stappen. Dit moet worden gedaan voordat u BoostFS SU opnieuw koppelt.
1. Verwijder de DDLog-map uit C: en de inhoud
ervan 2. Verwijder ddboost_precert.ini bestand uit C:



=====================================================================================================Precert-logboeken inschakelen op de Linux-server met een ddboost back-upapplicatie.

Procedure for Enabling DDBoost Precert Logging on a Linux DDBOOST server: 

Map maken /DDLog

2. Verleen alle machtigingen aan alle gebruikers voor de /DDLog-directory met behulp van de volgende opdracht:

       $ chmod 777 /DDLog

3. Maak een bestand /ddboost_precert.ini met de volgende inhoud:

       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. Precert-logboeken worden gegenereerd in de map /DDLog.
=======================================================================================


Precert-logboeken inschakelen op Windows Server met een ddboost back-upapplicatie.  

1. Maak ddboost_precert.ini onder C:  schijf met de volgende inhoud:

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. Maak een map met de naam DDLog onder station C:. De precert-logbestanden worden in deze map gemaakt. Geef alle lees-/schrijfmachtigingen op voor de DDLog-directory, zodat logbestanden kunnen worden gemaakt en toegevoegd.


NOTITIE:
De bovenstaande configuratie maakt maximaal 3 precert-logbestanden van elk ongeveer 500 MB.
Er kunnen verschillende waarden worden gebruikt voor num_log_files en log_file_size naar eigen goeddunken.  Maar 3 bestanden van elk 500 MB zouden voldoende moeten zijn voor het doel.
Als 1,5 GB vrije ruimte niet mogelijk is op het clientsysteem, kan de waarde van log_file_size worden verlaagd naar 200.
Zorg ervoor dat er voldoende schijfruimte beschikbaar is op het clientsysteem voordat u precertlogboeken inschakelt.
 

Opschoonactiviteit en uitschakelen van precert-logboekregistratie

Zodra precert-logboeken zijn verzameld na het probleem, schakelt u precert-logboekregistratie uit met de volgende stappen. 
1. Verwijder de DDLog-map uit C: en de inhoud
ervan 2. Verwijder ddboost_precert.ini bestand uit C:

Affected Products

Data Domain

Products

Data Domain
Article Properties
Article Number: 000020437
Article Type: How To
Last Modified: 10 Nov 2025
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.