Data Domain: Povolení protokolování rozhraní API funkce DD Boost | Protokoly předběžného certifikátu
Summary: Tento článek znalostní databáze vysvětluje, jak povolit protokolování doplňku DD Boost při odstraňování problémů souvisejících s produkty Boost a BoostFS. Tomu se říká protokol precert. ...
Instructions
ddboost_precert.ini umožňuje hlubší diagnostiku. Nesprávné umístění souboru, chybějící oprávnění nebo chybná konfigurace mohou zabránit generování protokolu.
Důvody pro povolení protokolování na úrovni rozhraní API (precert):
- Operace DD Boost nebo BoostFS selhávají nebo se chovají neočekávaně.
- Technický tým nebo podpora si vyžádá podrobné protokoly na úrovni rozhraní API pro analýzu.
- Navzdory očekávané aktivitě zvýšení výkonu se negenerují žádné protokoly.
Obecné poznámky:
- Protokolování před certifikátem povolte pouze v případě, že si to technické oddělení nebo podpora výslovně vyžádá.
- Pečlivě sledujte místo na disku; Kmeny mohou rychle růst.
- Zajistěte správná oprávnění a umístění souborů.
- Demontujte
.inisoubor pro zakázání protokolování. - Aby se změny projevily, je nutné systém BoostFS odpojit a znovu připojit.
Umístění souborů podle operačního systému
| Operační systém | ddboost_precert.ini Umístění |
ddboost_precert.log Umístění |
|---|---|---|
| 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 |
Pro verze BOOST/BoostFS starší než 7.0
Vytvořte prázdný soubor s názvem ddboost_precert.ini na příslušném místě (viz tabulka výše). To umožňuje protokolování do výchozí cesty.
Pro BOOST/BoostFS verze 7.0 a novější
Vytvoření nakonfigurovaného ddboost_precert.ini soubor s následujícím obsahem:
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
- Tato konfigurace vytvoří čtyři soubory protokolu, každý o velikosti 512 MB (celkem 2 GB).
- Upravit
num_log_filesalog_file_sizepodle potřeby. - Protokoly lze v případě omezeného místa na disku přesměrovat na jiné místo.
Nastavení klienta Linux BOOSTFS
- Vytvoření
/DDLogadresář:mkdir /DDLogchmod 777 /DDLog
-
Vytvoření
/ddboost_precert.inis výše uvedenou konfigurací. -
Ujistěte se, že je BoostFS odpojen a znovu připojen:
mount -o log-level=debug <mount_point>
Nastavení klienta Windows BOOSTFS
- Vytvoření
C:\ddboost_precert.inis následujícím obsahem:-
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
-
-
Vytvoření
C:\DDLoga přiřaďte plná oprávnění ke čtení/zápisu. -
Odpojte a znovu připojte BoostFS s povoleným protokolováním ladění.
Vyčištění a zakázání protokolování
- Odstraňte
ddboost_precert.ini. - Odstraňte
DDLogadresář a jeho obsah. - Změny se projeví opětovným připojením BoostFS.
- Shromážděte protokoly BoostFS z
/opt/emc/boostfs/log.
Additional Information
U verzí BOOST/BoostFS starších než 7.0 jsou protokoly před certifikátem povoleny vytvořením prázdného souboru s přesným názvem "ddboost_precert.ini" v umístění uvedeném v tabulce níže. Pokud tak učiníte, rozhraní DD Boost SDK API povolí toto protokolování do výchozího umístění a názvu souboru, jak je znázorněno v následující tabulce:
Tento nástroj by měl být povolen pouze na žádost technických týmů nebo týmů podpory a vzhledem k množství generovaných protokolů je třeba tento zápis co nejdříve zakázat.
| Operační systém | Umístění souboru ddboost_precert.ini | ddboost_precert.log umístění souboru |
|---|---|---|
| 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 |
U verzí BOOST a BoostFS 7.0 a novějších je třeba vytvořit soubor "ddboost_precert.ini" na stejných místech jako výše, ale nesmí být prázdný, je třeba jej inicializovat s níže uvedeným obsahem, jinak nedojde k vytvoření protokolů :
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
S výše uvedeným nastavením vytvoří 4 soubory po 512 MB, takže celkem zabere pouze 2 GB místa na disku.
Pokud 4 soubory, každý o velikosti 512 MB, nepokryly časový rámec potřebný k odstranění problémů, upravte množství souborů a jejich velikost pomocí parametrů "num_log_files" a "log_file_size".
S uvedenou konfigurací budou protokoly vytvořeny ve stejném umístění jako v tabulce, ale pokud kořenový oddíl operačního systému není dostatečně velký, je zde možnost vytvořit protokoly na jiném místě.
POZNÁMKA: Tato složka musí být přítomna ve stejné cestě jako soubor ddboost_precert.ini (čeká se na potvrzení někým, kdo to ví lépe, pokud je to pravda, znemožnilo by to zapsat protokol na jiný oddíl než na typicky malý kořenový adresář)
Pokud je k dispozici soubor .ini (a v případě verze 7.0 nebo novější má příslušný obsah), je ve složce /DDLog vygenerován soubor protokolu s názvem ddboost_precert.log (pokud je taková cesta nakonfigurovaná).
ddboost_precert.log se může velmi rychle zvětšovat, protože všechna volání rozhraní API se protokolují do souboru, proto věnujte pozornost množství místa, které je pro protokoly v umístění klienta k dispozici, protože mohou způsobit zaplnění oddílu a způsobit prostoje a nepříjemnosti pro zákazníka.
Protokolování zastavíte odebráním souboru ddboost_precert.ini okamžitě se zastaví protokoly do nakonfigurovaného souboru.
U jiného zálohovacího softwaru, který používá ddboost, může být nutné restartovat služby, pokud není vytvořen žádný soubor protokolu, který by zjistil přítomnost nebo nepřítomnost souboru ddboost_precert.ini
=====================================================================================================
Postup povolení protokolů precert na serveru
Linux boostfs1. Vytvořte adresář DDLog jako /DDLog
2. Vytvořte soubor ddboost_precert.ini / cestu s následujícím obsahem
:precert_enabled=pravda
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=pravda
ddcl_logs_sev=4
3. Uložte výše uvedený obsah do souboru - ddboost_precert.ini
4. Ujistěte se, že adresář /DDLog má oprávnění k zápisu. Zadejte všechny soubory do adresáře /DDLog.
a. změňte oprávnění na DDLog i ddboost_precert.ini
b. spusťte příkaz 'sudo chmod 777 DDLog/ ddboost_precert.ini'5
. Shromážděte protokoly BoostFS na úrovni ladění.
a. Odpojte a znovu připojte přípojný bod BoostFS pomocí možnosti '-o log-level=debug'
b. Úroveň protokolu můžete také aktualizovat v souboru boostfs.conf v adresáři /opt/emc/boostfs/etc. Stále je třeba odpojit a odpojit disk BoostFS.
c. Proveďte operaci zálohování na přípojném bodu BoostFS.
d. Zadejte všechny soubory v adresáři – /opt/emc/boostfs/log
.======================================================================================================
Povolení protokolů precert v systému Windows boostfs Server
1. Vytvořte ddboost_precert.ini v části C: disk s následujícím obsahem:
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. Vytvořte složku s názvem DDLog pod jednotkou C:. V této složce se vytvoří soubory protokolu precert. Zajistěte prosím všechna oprávnění pro čtení a zápis do adresáře DDLog, aby bylo možné vytvářet a připojovat soubory protokolu.
POZNÁMKA:
Výše uvedená konfigurace vytvoří maximálně 3 soubory protokolu precert, každý o velikosti přibližně 500 MB.
Pro num_log_files a log_file_size lze použít různé hodnoty, jak uznáte za vhodné. K tomuto účelu by však měly stačit 3 soubory po 500 MB.
Pokud v klientském systému není možné 1,5 GB volného místa, lze hodnotu log_file_size snížit na 200.
Před povolením protokolů předběžného certifikátu ověřte, zda je v klientském systému dostatek místa na disku.
3. Odpojte a znovu připojte přípojný bod BoostFS pomocí možnosti '-o log-level=debug'
Činnost čištění a zakázání protokolování
před certifikátemJakmile jsou po problému shromážděny protokoly precert, zakažte protokolování precert pomocí následujících kroků. To je nutné provést před opětovnou montáží BoostFS SU.
1. Odstraňte složku DDLog z C: a její obsah
2. Odstraňte ddboost_precert.ini soubor z C:
=====================================================================================================Povolte protokoly precert na serveru Linux pomocí zálohovací aplikace ddboost.
Postup povolení protokolování DDBoost Precert na serveru Linux DDBoost:
Vytvořte adresář /DDLog
2. Následujícím příkazem udělte všechna oprávnění všem uživatelům k adresáři /DDLog:
$ chmod 777 /DDLog
3. Vytvořte soubor /ddboost_precert.ini s následujícím obsahem:
precert_enabled=pravda
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=pravda
ddcl_logs_sev=4
4. Protokoly předběžného certifikátu se vygenerují v adresáři /DDLog.
=======================================================================================
Povolte protokoly precert na Windows Serveru pomocí zálohovací aplikace ddboost.
1. Vytvořte ddboost_precert.ini v části C: disk s následujícím obsahem:
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. Vytvořte složku s názvem DDLog pod jednotkou C:. V této složce se vytvoří soubory protokolu precert. Zajistěte prosím všechna oprávnění pro čtení a zápis do adresáře DDLog, aby bylo možné vytvářet a připojovat soubory protokolu.
POZNÁMKA:
Výše uvedená konfigurace vytvoří maximálně 3 soubory protokolu precert, každý o velikosti přibližně 500 MB.
Pro num_log_files a log_file_size lze použít různé hodnoty, jak uznáte za vhodné. K tomuto účelu by však měly stačit 3 soubory po 500 MB.
Pokud v klientském systému není možné 1,5 GB volného místa, lze hodnotu log_file_size snížit na 200.
Před povolením protokolů předběžného certifikátu ověřte, zda je v klientském systému dostatek místa na disku.
Činnost čištění a zakázání protokolování
před certifikátemJakmile jsou po problému shromážděny protokoly precert, zakažte protokolování precert pomocí následujících kroků.
1. Odstraňte složku DDLog z C: a její obsah
2. Odstraňte ddboost_precert.ini soubor z C: