Data Domain: Aktivering af DD Boost API-logføring | Precert-logfiler
Summary: Denne vidensbaseartikel forklarer, hvordan du aktiverer logføring af DD Boost-plugin ved fejlfinding af problemer relateret til Boost og BoostFS. Dette kaldes en precert-log.
Instructions
ddboost_precert.ini Filen giver mulighed for dybere diagnosticering. Forkert filplacering, manglende tilladelser eller forkert konfiguration kan forhindre loggenerering.
Årsager til at aktivere logføring på API-niveau (precert):
- DD Boost- eller BoostFS-handlinger mislykkes eller opfører sig uventet.
- Teknik- eller supportanmodninger om detaljerede logfiler på API-niveau til analyse.
- Der genereres ingen logfiler på trods af forventet Boost-aktivitet.
Generelle bemærkninger:
- Aktivér kun precert-logføring, når teknikeren eller supporten udtrykkeligt anmoder om det.
- Overvåg diskplads nøje; Logfiler kan vokse hurtigt.
- Sørg for korrekte tilladelser og filplacering.
- Fjern
.inifil for at deaktivere logføring. - BoostFS skal afmonteres og genmonteres, for at ændringerne kan træde i kraft.
Filplaceringer efter operativsystem
| Operativsystem | ddboost_precert.ini Placering |
ddboost_precert.log Placering |
|---|---|---|
| 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-versioner før 7.0
Opret en tom fil med navnet ddboost_precert.ini på det relevante sted (se ovenstående tabel). Dette gør det muligt at logge på standardstien.
Til BOOST/BoostFS version 7.0 og nyere
Opret en konfigureret ddboost_precert.ini fil med følgende indhold:
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 konfiguration opretter fire logfiler på hver 512 MB (2 GB i alt).
- Justere
num_log_filesoglog_file_sizeefter behov. - Logfiler kan omdirigeres til en anden placering, hvis diskpladsen er begrænset.
Opsætning af Linux BOOSTFS Client
- Opret
/DDLogmappe:mkdir /DDLogchmod 777 /DDLog
-
Opret
/ddboost_precert.inimed konfigurationen ovenfor. -
Sørg for, at BoostFS er afmonteret og genmonteret:
mount -o log-level=debug <mount_point>
Konfiguration af Windows BOOSTFS Client
- Opret
C:\ddboost_precert.inimed følgende indhold:-
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
-
-
Opret
C:\DDLogog tildele fulde læse-/skrivetilladelser. -
Afmonter og genmonter BoostFS med fejlfindingslogføring aktiveret.
Oprydning og deaktivering af logføring
- Slet
ddboost_precert.inifil. - Slet
DDLogbibliotek og dets indhold. - Monter BoostFS igen for at anvende ændringerne.
- Indsaml BoostFS-logfiler fra
/opt/emc/boostfs/log.
Additional Information
For BOOST/BoostFS-versioner før 7.0 aktiveres precert-logfiler ved at oprette en tom fil med navnet "ddboost_precert.ini" på den placering, der er angivet i tabellen nedenfor. Hvis du gør det, aktiveres DD Boost SDK API til denne logføring til standardplaceringen og filnavnet som vist i tabellen nedenfor:
Dette værktøj bør kun aktiveres, når tekniker- eller supportteamene anmoder om det, og på grund af mængden af logfiler, der genereres, skal man sørge for, at denne logføring deaktiveres så hurtigt som muligt.
| Operativsystem | Filplacering ddboost_precert.ini | Filplacering 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 versioner skal filen "ddboost_precert.ini" oprettes på de samme placeringer som ovenfor, men den må ikke være tom, den skal initialiseres med indholdet nedenfor, ellers vil det ikke resultere i, at logfilerne oprettes :
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 ovenstående indstillinger opretter den 4 filer på 512 MB hver, så i alt tager det kun 2 GB diskplads.
Hvis 4 filer på hver 512 MB ikke dækkede den tidsramme, der kræves til fejlfinding, skal du justere antallet af filer og deres størrelse ved hjælp af parametrene "num_log_files" og "log_file_size".
Når konfigurationen er vist, oprettes logfilerne på samme placering som i tabellen, men der er mulighed for at oprette logfilerne et andet sted, hvis operativsystemets rodpartition ikke er stor nok.
SEDDEL: Denne mappe skal være til stede i samme sti som ddboost_precert.ini-filen (afventer bekræftelse fra en person, der ved bedre, hvis dette er sandt, ville det gøre det umuligt at skrive loggen til en anden partition end den typisk lille rod)
Når den .ini fil er til stede (og i tilfælde for 7.0 eller nyere har det relevante indhold), genereres en logfil med navnet ddboost_precert.log i mappen /DDLog (hvis en sådan sti er den konfigurerede).
Den ddboost_precert.log kan vokse meget hurtigt, da alle API-kald logges i filen, og vær derfor opmærksom på mængden af ledig plads på klientplaceringen til logfilerne, da de kan få partitionen til at fylde op og resultere i nedetid og gener for kunden.
Hvis du vil stoppe logføringen, stopper logfilenmed det samme ved at fjerne filen ddboost_precert.ini.
For anden sikkerhedskopieringssoftware, der bruger ddboost, kan det være nødvendigt at genstarte tjenesterne, hvis der ikke oprettes en logfil til at registrere tilstedeværelsen eller fraværet af ddboost_precert.ini-filen
=====================================================================================================
Trin til at aktivere precert-logfiler på linux boostfs server
1. Opret en mappe DDLog som /DDLog
2. Opret en fil ddboost_precert.ini på / sti med følgende indhold
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. Gem ovenstående indhold i filen - ddboost_precert.ini
4. Sørg for, at mappen /DDLog har skrivetilladelserne. Angiv alle filerne i mappen /DDLog.
a. ændre tilladelser på både DDLog og ddboost_precert.ini
b. køre 'sudo chmod 777 DDLog/ ddboost_precert.ini'5
. Indsaml BoostFS-logfiler på fejlfindingsniveau.
en. Afmonter og monter BoostFS-monteringspunktet igen med indstillingen '-o log-level=debug'
b. Du kan også opdatere logniveauet i boostfs.conf-filen i mappen /opt/emc/boostfs/etc. Du skal stadig afmontere BoostFS-drevet
.c. Udfør sikkerhedskopieringen på BoostFS-monteringspunktet.
d. Angiv alle filerne i mappen - /opt/emc/boostfs/log
======================================================================================================
Aktivér precert-logfiler på Windows BoostFS Server
1. Opret ddboost_precert.ini under C: drev med følgende indhold:
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. Opret en mappe med navnet DDLog under C: drev. Precert-logfilerne oprettes under denne mappe. Angiv alle læse-/skrivetilladelser til DDLog-mappen, så logfiler kan oprettes og tilføjes.
SEDDEL:
Ovenstående konfiguration vil oprette maks. 3 precert-logfiler på ca. 500 MB hver.
Der kan anvendes forskellige værdier til num_log_files og log_file_size, som det skønnes passende. Men 3 filer på 500MB hver burde være tilstrækkelige til formålet.
Hvis 1,5 GB ledig plads ikke er mulig på klientsystemet, kan værdien af log_file_size reduceres til 200.
Sørg for, at der er tilstrækkelig diskplads på klientsystemet, før du aktiverer precert-logfiler.
3. Afmonter og monter BoostFS-monteringspunktet igen med indstillingen '-o log-level=debug'
Oprydningsaktivitet og deaktivering af precert-logføring
Når precert-logfiler er indsamlet efter problemet, skal du deaktivere precert-logføring med følgende trin. Dette skal gøres, før BoostFS SU monteres igen.
1. Slet DDLog-mappen fra C: og dens indhold
2. Slet ddboost_precert.ini fil fra C:
=====================================================================================================Aktivér precert-logfiler på Linux-serveren med et DDBOOST-sikkerhedskopieringsprogram.
Procedure for aktivering af DDBoost Precert-logføring på en Linux DDSoot-server:
Opret mappe /DDLog
2. Giv alle tilladelser til alle brugere til mappen /DDLog ved hjælp af følgende kommando:
$ chmod 777 /DDLog
3. Opret fil / ddboost_precert.ini med følgende indhold:
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-logfiler genereres i /DDLog-mappen.
=======================================================================================
Aktivér precert-logfiler på Windows Server med et DDBOOST-sikkerhedskopieringsprogram.
1. Opret ddboost_precert.ini under C: drev med følgende indhold:
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. Opret en mappe med navnet DDLog under C: drev. Precert-logfilerne oprettes under denne mappe. Angiv alle læse-/skrivetilladelser til DDLog-mappen, så logfiler kan oprettes og tilføjes.
SEDDEL:
Ovenstående konfiguration vil oprette maks. 3 precert-logfiler på ca. 500 MB hver.
Der kan anvendes forskellige værdier til num_log_files og log_file_size, som det skønnes passende. Men 3 filer på 500MB hver burde være tilstrækkelige til formålet.
Hvis 1,5 GB ledig plads ikke er mulig på klientsystemet, kan værdien af log_file_size reduceres til 200.
Sørg for, at der er tilstrækkelig diskplads på klientsystemet, før du aktiverer precert-logfiler.
Oprydningsaktivitet og deaktivering af precert-logføring
Når precert-logfiler er indsamlet efter problemet, skal du deaktivere precert-logføring med følgende trin.
1. Slet DDLog-mappen fra C: og dens indhold
2. Slet ddboost_precert.ini fil fra C: