Data Domain: Aktivere DD Boost API-logging | Precert-logger

Summary: Denne kunnskapsbaseartikkelen forklarer hvordan du aktiverer DD Boost-pluginlogging når du feilsøker problemer relatert til Boost og BoostFS. Dette kalles 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

Merk: DD Boost-plugin-modulen logger ikke detaljert API-aktivitet som standard. Aktivering av precert-logging ved hjelp av ddboost_precert.ini Filen gir mulighet for dypere diagnostikk. Feil filplassering, manglende tillatelser eller feilkonfigurasjon kan hindre logggenerering.

Grunner til å aktivere logging på API-nivå (precert):

  • DD Boost- eller BoostFS-operasjoner mislykkes eller oppfører seg uventet.
  • Tekniker- eller støtteforespørsler om detaljerte API-nivålogger for analyse.
  • Ingen logger genereres til tross for forventet Boost-aktivitet.

Generelle merknader:

  • Aktiver bare precert-logging når teknisk avdeling eller kundestøtte uttrykkelig ber om det.
  • Overvåk diskplass nøye; Logger kan vokse raskt.
  • Sørg for riktige tillatelser og filplassering.
  • Ta ut .ini -fil for å deaktivere logging.
  • BoostFS må demonteres og monteres på nytt for at endringene skal tre i kraft.

Filplasseringer etter operativsystem

Operativsystem ddboost_precert.ini Område ddboost_precert.log Område
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

For BOOST-/BoostFS-versjoner fra før 7.0

Opprett en tom fil med navnet ddboost_precert.ini på riktig sted (se tabell over). Dette aktiverer logging til standardbanen.


For BOOST/BoostFS versjon 7.0 og nyere

Opprett en konfigurert ddboost_precert.ini fil med følgende innhold:

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
  • Denne konfigurasjonen oppretter fire loggfiler på 512 MB hver (totalt 2 GB).
  • Justere num_log_files og log_file_size etter behov.
  • Logger kan omdirigeres til en annen plassering hvis diskplassen er begrenset.

Oppsett av Linux BOOSTFS-klient

  1. Opprett /DDLog adressebok:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Opprett /ddboost_precert.ini med konfigurasjonen ovenfor.

  3. Forsikre deg om at BoostFS er avmontert og montert på nytt:

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

Klientoppsett for Windows BOOSTFS

  1. Opprett C:\ddboost_precert.ini med følgende innhold:
    • 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. Opprett C:\DDLog og tilordne fulle lese-/skrivetillatelser.

  3. Demonter og monter BoostFS på nytt med feilsøkingslogging aktivert.


Opprydding og deaktivering av logging

  1. Slett ddboost_precert.ini fil.
  2. Slett DDLog katalog og innholdet.
  3. Monter BoostFS på nytt for å ta i bruk endringene.
  4. Samle inn BoostFS-logger fra /opt/emc/boostfs/log.

Additional Information

For tidligere BOOST-/BoostFS-versjoner enn 7.0 aktiveres precert-logger ved å opprette en tom fil med navnet "ddboost_precert.ini" på plasseringen som er angitt i tabellen nedenfor. Hvis du gjør dette, vil DD Boost SDK API aktivere denne loggingen til standardplasseringen og filnavnet som vist i tabellen nedenfor: 

Dette verktøyet skal bare aktiveres når ingeniør- eller støtteteamene ber om det, og på grunn av mengden logger som genereres, bør det utvises forsiktighet slik at loggingen deaktiveres så snart som mulig.

 

Operativsystem Filplassering ddboost_precert.ini Filplassering 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


For BOOST- og BoostFS 7.0- og nyere utgivelser må "ddboost_precert.ini"-filen opprettes på samme sted som ovenfor, men den kan ikke være tom, den må initialiseres med innholdet nedenfor, ellers vil det ikke føre til at loggene blir opprettet :
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 innstillingene ovenfor vil den lage 4 filer på 512 MB hver, så totalt vil det bare ta 2 GB diskplass.

Hvis 4 filer på 512 MB hver ikke dekket tidsrammen som kreves for feilsøking, må du justere mengden filer og størrelsen på dem ved hjelp av parametrene "num_log_files" og "log_file_size".

Med konfigurasjonen vist blir loggene opprettet på samme sted som i tabellen, men det er mulighet for å opprette loggene på et annet sted hvis rotpartisjonen for operativsystemet ikke er stor nok.

NOTAT: Denne mappen må være til stede i samme bane som ddboost_precert.ini filen (i påvente av bekreftelse fra noen som vet bedre, hvis dette er sant, ville det gjøre det umulig å skrive loggen til en annen partisjon enn den vanligvis lille roten) 


Når den .ini filen finnes (og i tilfelle for 7.0 eller senere, har riktig innhold), genereres en loggfil med navnet ddboost_precert.log i mappen /DDLog (hvis denne banen er konfigurert).

ddboost_precert.log kan vokse veldig raskt ettersom alle API-kall logges til filen, og vær derfor oppmerksom på hvor mye plass som er tilgjengelig på klientstedet for loggene, da de kan føre til at partisjonen fylles opp og føre til nedetid og ulempe for kunden.

Hvis du vil stoppe loggingen, fjerner du filen ddboost_precert.ini logger til den konfigurerte filen for å stoppe umiddelbart.
 
Enhver endring i ddboost_precert.ini-filen vil kreve at BOOSTFS demonteres og deretter monteres på nytt for at endringene skal tre i kraft.
For annen sikkerhetskopieringsprogramvare som bruker ddboost, kan det være nødvendig å starte tjenestene på nytt hvis det ikke opprettes en loggfil for å oppdage at filen er til stede eller fraværende ddboost_precert.ini
 
[1] Den ddboost_precert.ini filen må plasseres i roten av installasjonskatalogen.  Det kan hete: D:\ osv.   Hvis du plasserer filen på en annen stasjon, og ingen loggfil opprettes, kan du prøve C:\ likevel.

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

Trinn for å aktivere precert-logger på linux boostfs-server

1. Opprett en katalog-DDLog som /DDLog

2. Opprett en fil ddboost_precert.ini på / sti med følgende innhold
 
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. Lagre innholdet ovenfor i filen - ddboost_precert.ini

4. Kontroller at /DDLog-katalogen har skrivetillatelser. Angi alle filene i /DDLog-katalogen.

a. endre tillatelser på både DDLog og ddboost_precert.ini
b. kjør 'sudo chmod 777 DDLog/ ddboost_precert.ini'5

. Samle inn feilsøkingsnivå BoostFS-logger.

en. Demonter og monter BoostFS-monteringspunktet på nytt med alternativet '-o log-level=debug'
b. Du kan også oppdatere loggnivået i boostfs.conf-filen i /opt/emc/boostfs/etc-katalogen. Du må fortsatt demontere BoostFS-disken.
c. Utfør sikkerhetskopieringen på monteringspunktet for BoostFS.
d. Oppgi alle filene i katalogen – /opt/emc/boostfs/log


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

Aktiver precert-logger på Windows BoostFS-server

1. Opprett ddboost_precert.ini under C:  stasjon med følgende innhold:

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. Opprett en mappe med navnet DDLog under C: stasjon. Precert-loggfilene opprettes under denne mappen. Oppgi alle lese-/skrivetillatelser til DDLog-katalogen slik at loggfiler kan opprettes og legges til.


NOTAT:
Konfigurasjonen ovenfor vil opprette maks 3 precert-loggfiler på omtrent 500 MB hver.
Ulike verdier kan brukes for num_log_files og log_file_size etter eget ønske.  Men 3 filer på 500MB hver bør være tilstrekkelig formålet.
Hvis 1,5 GB ledig plass ikke er mulig på klientsystemet, kan verdien av log_file_size reduseres til 200.
Kontroller at det er nok diskplass tilgjengelig på klientsystemet før du aktiverer precert-logger.

3. Demonter og monter BoostFS-monteringspunktet på nytt med alternativet '-o log-level=debug'

 
Oppryddingsaktivitet og deaktivering av precertlogging

Når precert-logger er samlet inn etter problemet, deaktiverer du precert-logging med følgende trinn. Dette må gjøres før du monterer BoostFS SU på nytt.
1. Slett DDLog-mappen fra C: og innholdet
2. Slett ddboost_precert.ini fil fra C:



=====================================================================================================Aktiver precert-logger på Linux-server med et ddboost-sikkerhetskopieringsprogram.

Fremgangsmåte for aktivering av DDBoost Precert-logging på en Linux DDBOOST-server: 

Opprett katalog / DDLog

2. Gi alle tillatelser til alle brukere for /DDLog-katalogen ved hjelp av følgende kommando:

       $ chmod 777 / DDLog

3. Opprett fil /ddboost_precert.ini med følgende innhold:

       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-logger genereres i /DDLog-katalogen.
=======================================================================================


Aktiver precert-logger på Windows Server med et ddboost-sikkerhetskopieringsprogram.  

1. Opprett ddboost_precert.ini under C:  stasjon med følgende innhold:

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. Opprett en mappe med navnet DDLog under C: stasjon. Precert-loggfilene opprettes under denne mappen. Oppgi alle lese-/skrivetillatelser til DDLog-katalogen slik at loggfiler kan opprettes og legges til.


NOTAT:
Konfigurasjonen ovenfor vil opprette maks 3 precert-loggfiler på omtrent 500 MB hver.
Ulike verdier kan brukes for num_log_files og log_file_size etter eget ønske.  Men 3 filer på 500MB hver bør være tilstrekkelig formålet.
Hvis 1,5 GB ledig plass ikke er mulig på klientsystemet, kan verdien av log_file_size reduseres til 200.
Kontroller at det er nok diskplass tilgjengelig på klientsystemet før du aktiverer precert-logger.
 

Oppryddingsaktivitet og deaktivering av precertlogging

Når precert-logger er samlet inn etter problemet, deaktiverer du precert-logging med følgende trinn. 
1. Slett DDLog-mappen fra C: og innholdet
2. Slett ddboost_precert.ini fil fra 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.