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.
Instructions
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_filesoglog_file_sizeetter behov. - Logger kan omdirigeres til en annen plassering hvis diskplassen er begrenset.
Oppsett av Linux BOOSTFS-klient
- Opprett
/DDLogadressebok:mkdir /DDLogchmod 777 /DDLog
-
Opprett
/ddboost_precert.inimed konfigurasjonen ovenfor. -
Forsikre deg om at BoostFS er avmontert og montert på nytt:
mount -o log-level=debug <mount_point>
Klientoppsett for Windows BOOSTFS
- Opprett
C:\ddboost_precert.inimed 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
-
-
Opprett
C:\DDLogog tilordne fulle lese-/skrivetillatelser. -
Demonter og monter BoostFS på nytt med feilsøkingslogging aktivert.
Opprydding og deaktivering av logging
- Slett
ddboost_precert.inifil. - Slett
DDLogkatalog og innholdet. - Monter BoostFS på nytt for å ta i bruk endringene.
- 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.
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
=====================================================================================================
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: