Data Domain: Aktivera DD Boost API-loggning | Precert-loggar

Summary: I den här kunskapsartikeln beskrivs hur du aktiverar loggning av DD Boost-insticksprogrammet vid felsökning av problem relaterade till Boost och BoostFS. Detta kallas för en precert-logg. ...

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

Obs! DD Boost-insticksprogrammet loggar inte detaljerad API-aktivitet som standard. Aktivera precert-loggning med hjälp av ddboost_precert.ini Fil för djupare diagnostik. Felaktig filplacering, behörigheter som saknas eller felaktig konfiguration kan förhindra logggenerering.

Anledningar till att aktivera loggning på API-nivå (precert):

  • DD Boost- eller BoostFS-åtgärder misslyckas eller beter sig oväntat.
  • Tekniker eller support begär detaljerade loggar på API-nivå för analys.
  • Inga loggar genereras trots förväntad Boost-aktivitet.

Allmänna anmärkningar:

  • Aktivera endast förcertifieringsloggning när det uttryckligen begärs av teknikavdelningen eller supporten.
  • Övervaka diskutrymmet noga; Stockar kan växa snabbt.
  • Säkerställ korrekta behörigheter och filplacering.
  • Ta bort .ini för att inaktivera loggning.
  • BoostFS måste demonteras och monteras om för att ändringarna ska träda i kraft.

Filplatser efter operativsystem

Operativsystem ddboost_precert.ini Plats ddboost_precert.log Plats
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris 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-versioner före 7.0

Skapa en tom fil med namnet ddboost_precert.ini på lämplig plats (se tabellen ovan). Detta aktiverar loggning till standardsökvägen.


För BOOST/BoostFS version 7.0 och senare

Skapa en konfigurerad ddboost_precert.ini fil med följande innehåll:

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
  • Den här konfigurationen skapar fyra loggfiler på 512 MB vardera (totalt 2 GB).
  • Justera num_log_files och log_file_size efter behov.
  • Loggar kan omdirigeras till en annan plats om diskutrymmet är begränsat.

Konfiguration av Linux BOOSTFS-klient

  1. Skapa /DDLog katalog:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Skapa /ddboost_precert.ini med konfigurationen ovan.

  3. Se till att BoostFS är avmonterad och återmonterad:

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

Installation av Windows BOOSTFS-klient

  1. Skapa C:\ddboost_precert.ini med följande innehåll:
    • 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. Skapa C:\DDLog och tilldela fullständiga läs-/skrivbehörigheter.

  3. Demontera och återmontera BoostFS med felsökningsloggning aktiverad.


Rensa och inaktivera loggning

  1. Ta bort ddboost_precert.ini fil.
  2. Ta bort DDLog katalog och dess innehåll.
  3. Återmontera BoostFS för att tillämpa ändringarna.
  4. Samla in BoostFS-loggar från /opt/emc/boostfs/log.

Additional Information

För BOOST/BoostFS-versioner före 7.0 aktiveras precert-loggar genom att skapa en tom fil med namnet exakt "ddboost_precert.ini" på den plats som anges i tabellen nedan. Om du gör det aktiverar DD Boost SDK-API:et den här loggningen till standardplatsen och filnamnet enligt tabellen nedan: 

Det här verktyget bör endast aktiveras när det begärs av teknik- eller supportteamen, och på grund av mängden loggar som genereras bör du vara försiktig så att den här loggningen inaktiveras så snart som möjligt.

 

Operativsystem Filplats ddboost_precert.ini Filplats ddboost_precert.log
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris 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- och BoostFS 7.0 och senare versioner måste "ddboost_precert.ini"-filen skapas på samma platser som ovan, men den får inte vara tom, den måste initieras med innehållet nedan, annars kommer det inte att resultera i att loggarna skapas :
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



Med inställningarna ovan kommer det att skapa 4 filer på 512 MB vardera, så totalt tar det bara 2 GB diskutrymme.

Om 4 filer på 512 MB vardera inte täcker den tidsram som krävs för felsökning, justera antalet filer och deras storlek med parametrarna "num_log_files" och "log_file_size".

När konfigurationen visas skapas loggarna på samma plats som i tabellen, men det finns möjlighet att skapa loggarna på en annan plats om operativsystemets rotpartition inte är tillräckligt stor.

NOT: Den här mappen måste finnas i samma sökväg som den ddboost_precert.ini filen (i väntan på bekräftelse av någon som vet bättre, om detta är sant skulle det göra det omöjligt att skriva loggen till någon annan partition än den vanligtvis lilla roten) 


När .ini-filen finns (och i fallet med 7.0 eller senare har rätt innehåll) genereras en loggfil med namnet ddboost_precert.log i mappen /DDLog (om en sådan sökväg är den som konfigurerats).

ddboost_precert.log kan växa mycket snabbt eftersom alla API-anrop loggas till filen, så var uppmärksam på mängden tillgängligt utrymme på klientplatsen för loggarna, eftersom de kan göra att partitionen fylls upp och resultera i driftstopp och besvär för kunden.

Om du vill stoppa loggningen och tar bort filen ddboost_precert.ini loggarna till den konfigurerade filen stoppas omedelbart.
 
Alla ändringar i ddboost_precert.ini file kräver att BOOSTFS demonteras och sedan återmonteras för att ändringarna ska träda i kraft.
För andra säkerhetskopieringsprogram som använder ddboost kan det hända att tjänsterna startas om om ingen loggfil skapas för att identifiera ddboost_precert.ini filens närvaro eller frånvaro
 
[1] Den ddboost_precert.ini filen måste placeras i roten på installationskatalogen.  Den kan heta: D:\ osv.   Om du placerar filen i en annan enhet och ingen loggfil skapas försöker du med C:\ ändå.

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

Steg för att aktivera förcertifieringsloggar på Linux BoostFS-server

1. Skapa en DDLog-katalog som /DDLog

2. Skapa en fil ddboost_precert.ini på/sökväg med följande innehåll
 
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. Spara ovanstående innehåll i filen - ddboost_precert.ini

4. Kontrollera att katalogen /DDLog har skrivbehörighet. Ange alla filer i katalogen /DDLog.

a. ändra behörigheter på både DDLog och ddboost_precert.ini
b. kör 'sudo chmod 777 DDLog/ ddboost_precert.ini'5

. Samla in BoostFS-loggarna på felsökningsnivå.

a. Demontera och återmontera BoostFS-monteringspunkten med alternativet '-o log-level=debug'
b. Du kan även uppdatera loggnivån i boostfs.conf-filen i katalogen /opt/emc/boostfs/etc. Du måste fortfarande avmontera-montera BoostFS-enheten.
c. Kör säkerhetskopieringen på BoostFS-monteringspunkten.
d. Ange alla filer i katalogen – /opt/emc/boostfs/log


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

Aktivera förcertifieringsloggar på Windows BoostFS-server

1. Skapa ddboost_precert.ini under C:  enhet med följande innehåll:

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. Skapa en mapp med namnet DDLog under C:-enhet. Precert-loggfilerna skapas under den här mappen. Ange alla läs-/skrivbehörigheter till DDLog-katalogen så att loggfiler kan skapas och läggas till.


NOT:
Ovanstående konfiguration skapar högst 3 precert-loggfiler på cirka 500 MB vardera.
Olika värden kan användas för num_log_files och log_file_size som anses lämpliga.  Men 3 filer på 500 MB vardera borde räcka för ändamålet.
Om 1,5 GB ledigt utrymme inte är möjligt på klientsystemet kan värdet på log_file_size minskas till 200.
Kontrollera att det finns tillräckligt med diskutrymme på klientsystemet innan du aktiverar precert-loggar.

3. Demontera och återmontera BoostFS-monteringspunkten med alternativet "-o log-level=debug"

 
Rensningsaktivitet och inaktivering av precert-loggning

När precert-loggar har samlats in efter problemet inaktiverar du precert-loggning med följande steg. Detta måste göras innan du återmonterar BoostFS SU.
1. Ta bort DDLog-mappen från C: och dess innehåll
2. Ta bort ddboost_precert.ini fil från C:



=====================================================================================================Aktivera förcertifieringsloggar på Linux-servern med ett ddboost-säkerhetskopieringsprogram.

Procedur för att aktivera DDBoost-förcertifieringsloggning på en Linux DDBoost-server: 

Skapa katalogen /DDLog

2. Bevilja alla behörigheter till alla användare för /DDLog-katalogen med följande kommando:

       $ chmod 777 /DDLog

3. Skapa filen /ddboost_precert.ini med följande innehåll:

       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-loggar genereras i /DDLog-katalogen.
=======================================================================================


Aktivera precert-loggar på Windows Server med ett ddboost-säkerhetskopieringsprogram.  

1. Skapa ddboost_precert.ini under C:  enhet med följande innehåll:

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. Skapa en mapp med namnet DDLog under C:-enhet. Precert-loggfilerna skapas under den här mappen. Ange alla läs-/skrivbehörigheter till DDLog-katalogen så att loggfiler kan skapas och läggas till.


NOT:
Ovanstående konfiguration skapar högst 3 precert-loggfiler på cirka 500 MB vardera.
Olika värden kan användas för num_log_files och log_file_size som anses lämpliga.  Men 3 filer på 500 MB vardera borde räcka för ändamålet.
Om 1,5 GB ledigt utrymme inte är möjligt på klientsystemet kan värdet på log_file_size minskas till 200.
Kontrollera att det finns tillräckligt med diskutrymme på klientsystemet innan du aktiverar precert-loggar.
 

Rensningsaktivitet och inaktivering av precert-loggning

När precert-loggar har samlats in efter problemet inaktiverar du precert-loggning med följande steg. 
1. Ta bort DDLog-mappen från C: och dess innehåll
2. Ta bort ddboost_precert.ini fil från 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.