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. ...
Instructions
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
.inifö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_filesochlog_file_sizeefter behov. - Loggar kan omdirigeras till en annan plats om diskutrymmet är begränsat.
Konfiguration av Linux BOOSTFS-klient
- Skapa
/DDLogkatalog:mkdir /DDLogchmod 777 /DDLog
-
Skapa
/ddboost_precert.inimed konfigurationen ovan. -
Se till att BoostFS är avmonterad och återmonterad:
mount -o log-level=debug <mount_point>
Installation av Windows BOOSTFS-klient
- Skapa
C:\ddboost_precert.inimed 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
-
-
Skapa
C:\DDLogoch tilldela fullständiga läs-/skrivbehörigheter. -
Demontera och återmontera BoostFS med felsökningsloggning aktiverad.
Rensa och inaktivera loggning
- Ta bort
ddboost_precert.inifil. - Ta bort
DDLogkatalog och dess innehåll. - Återmontera BoostFS för att tillämpa ändringarna.
- 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.
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
=====================================================================================================
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: