Data Domain: Povolení protokolování rozhraní API funkce DD Boost – protokoly předběžného certifikátu
Summary: Tento článek vysvětluje, jak povolit protokolování doplňku Data Domain Boost (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 následující komponenty:
.iniZaká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í |
|---|---|---|
| Systém 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 a BoostFS starší než 7.0
Vytvořte 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 a 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).
- Nastavitelnost
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áře.
mkdir /DDLog
chmod 777 /DDLog
- Vytvoření
/ddboost_precert.inis výše uvedenou konfigurací.
- Ujistěte se, že BoostFS se odpojí a znovu připojí:
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. - Odpojit a znovu připojit BoostFS s povoleným protokolováním ladění.
Vyčištění a zakázání protokolování
- Odstraňte
ddboost_precert.ininezahrnujte mezery. - 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
Často kladené dotazy
Otázka: Co je protokolování DD Boost Precert? DD Boost Precert Logging je funkce diagnostického protokolování, která zaznamenává transakce rozhraní API DD Boost mezi klientem DD Boost a systémem Data Domain.
Odpověď: Běžně se používá k řešení problémů s výkonem, selhání, latencí a komunikací.
Otázka: Co zaznamenává protokolování Precert? Protokolování Precert zachycuje aktivitu rozhraní API funkce DD Boost, včetně operací čtení, zápisu, zálohování, obnovení, interakcí knihoven DD Boost, informací o časování volání rozhraní API a indikátorů latence na straně klienta.
Odpověď: Poskytuje podrobný přehled o chování rozhraní DD Boost API pro odstraňování problémů a analýzu výkonu.
Otázka: Proč se negenerují žádné protokoly předběžného certifikace? Ověřte, zda soubor ddboost_precert.ini existuje, nachází se v kořenovém adresáři operačního systému, zda existuje adresář protokolu, do kterého lze zapisovat data a zda byla zahájena nová operace zálohování nebo obnovení.
Odpověď: Nejčastějšími příčinami jsou chybějící konfigurace, nesprávné umístění, problémy s oprávněními nebo nedostatečná aktivita nové funkce DD Boost.
Otázka: Vygeneruje povolení protokolování před certifikátem protokoly okamžitě? Konfigurace povoluje pouze možnost protokolování.
Odpověď: Ne, soubory protokolu se generují pouze při přijetí nových požadavků rozhraní API DD Boost.
Otázka: Proč aktuálně spuštěná záloha negeneruje protokoly precert? Protokolování před certifikátem zachycuje pouze aktivitu rozhraní API iniciovanou po zjištění konfigurace.
Odpověď: Stávající úlohy zálohování nebo obnovení pokračují bez generování protokolů předběžného certifikace.
Otázka: Musím restartovat úlohu zálohování nebo obnovení? Pokud byla úloha již spuštěna, když bylo povoleno protokolování, spusťte novou operaci.
Odpověď: Ano, k vygenerování protokolů precert je vyžadována nová úloha zálohování nebo obnovení.
Otázka: Jaký je nejčastější důvod, proč protokolování precert nefunguje? Mezi běžné příčiny patří ddboost_precert.ini není na kořenové úrovni, je omylem pojmenován ddboost_precert.ini.txt, chybějící adresář protokolu nebo nedostatečná oprávnění.
Odpověď: Nejčastějšími příčinami jsou problémy s konfigurací a souborovým systémem.
Otázka: Kam by měl být soubor ddboost_precert.ini umístěn?
Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.
Odpověď: Soubor musí být umístěn v kořenovém adresáři operačního systému.
Otázka: Může být soubor ddboost_precert.ini uložen v jiné složce? Zásuvný modul DD Boost kontroluje pouze kořenový adresář operačního systému.
Odpověď: Ne, soubor musí být uložen v kořenovém adresáři.
Otázka: Jak mohu ověřit, že soubor ve skutečnosti není
ddboost_precert.ini.txt
Otevřete Průzkumník souborů, povolte Přípony názvů souborů a ověřte název souboru.
Odpověď: Ujistěte se, že je soubor pojmenován
ddboost_precert.ini and not ddboost_precert.ini.txt.
Otázka: Proč je DDLog Adresář prázdný po povolení protokolování? Mezi možné příčiny patří žádná nová aktivita DD Boost, problémy s oprávněními nebo konfigurační soubor, který nebyl rozpoznán.
Odpověď: Spusťte nové zálohování, obnovení nebo DDPCONNCHK Otestujte, abyste vygenerovali aktivitu.
Otázka: Co je to DDPCONNCHK A proč je to užitečné? DDPCONNCHK je nástroj pro ověření konektivity softwaru DD Boost.
Odpověď: Dokáže generovat aktivitu rozhraní DD Boost API a rychle potvrdit, že protokolování před certifikátem funguje.
Otázka: Umět DDPCONNCHK použít k otestování mé konfigurace? Inženýři často DDPCONNCHK Po povolení protokolování.
Odpověď: Ano, jedná se o běžný způsob, jak ověřit, zda se protokoly generují před reprodukcí problému.
Otázka: Proč se moje protokoly precert tak rychle zvětšují? Protokolování Precert zaznamenává každé volání rozhraní API DD Boost.
Odpověď: Velká zálohovací prostředí mohou v krátké době vygenerovat významný objem protokolů.
Otázka: Kolik místa na disku mám přidělit? Běžným doporučením je
num_log_files=3 and log_file_size=500.
Odpověď: To poskytuje přibližně 1,5 GB úložiště protokolů, než dojde k rotaci.
Otázka: Mohou protokoly precert zaplnit systém souborů? Protokolování může spotřebovávat značné místo na disku, pokud není monitorováno.
Odpověď: Ano, úplné systémy souborů mohou způsobit selhání zálohování, výpadky nebo přerušení služeb.
Otázka: Jaký je účel num_log_files? Tento parametr určuje počet zachovaných rotovaných souborů protokolu.
Odpověď: Například, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.
Otázka: Jaký je účel log_file_size? Tento parametr určuje maximální velikost každého souboru protokolu v MB.
Odpověď: Například log_file_size=500 umožňuje, aby se každý soubor před otočením zvětšil na 500 MB.
Otázka: Co laňs ddcl_logs_include=true Proveďte následující: Umožňuje protokolování klientské knihovny DD Boost v rámci protokolů před certifikací.
Odpověď: Doporučené nastavení je ddcl_logs_include=true.
Otázka: Co znamená ddcl_logs_sev=4 Význam Tento parametr řídí závažnost protokolování.
Odpověď: Úroveň závažnosti 4 obsahuje podrobné informace o odstraňování problémů a ladění.
Otázka: Potřebuji BoostFS Ladění protokolování navíc k protokolování precert? Další protokolování není vždy vyžadováno.
Odpověď: Pro BoostFS-specific problémy, povolení obou často poskytuje úplnější diagnostický obraz.
Otázka: Pro BoostFS, musím odpojit a znovu připojit? Odpojením a opětovným připojením se znovu inicializuje aktivita BoostFS.
Odpověď: V mnoha případech ano, pomáhá to iniciovat novou aktivitu DD Boost.
Otázka: Jaká je správná syntaxe protokolování ladění BoostFS? Správná syntaxe je -o log-level=debug.
Odpověď: Nepoužívat --o log-level=debug protože platí pouze jedna pomlčka.
Otázka: Proč se po opětovném připojení BoostFS náhle zobrazily protokoly precert? Opětovné připojení vytvoří nový cyklus inicializace pro BoostFS.
Odpověď: Protokolování začne, když dojde k nové aktivitě rozhraní DD Boost API a doplněk zjistí konfigurační soubor.
Otázka: Je restartování aplikace ekvivalentní opětovnému připojení BoostFS? Protokolování může aktivovat jakákoli akce, která vytvoří novou aktivitu rozhraní DD Boost API.
Odpověď: Obvykle ano, příklady zahrnují restartování RMAN, zálohovací software nebo spuštěný DDPCONNCHK.
Otázka: Umět RMAN Generovat protokoly precert bez odpojení BoostFS? RMAN může přímo iniciovat nové požadavky rozhraní API funkce DD Boost.
Odpověď: Ano, začínáme s novým RMAN Provoz je obvykle dostačující.
Otázka: Jak zakážu protokolování precert? Odstraňte ddboost_precert.ini nebo jej přejmenujte na ddboost_precert.ini.disabled.
Odpověď: Protokolování se aktivuje pouze v případě, že je zadán přesný název souboru ddboost_precert.ini Stávající
Otázka: Musím po odstranění souboru ini restartovat hostitele? Doplněk zkontroluje konfigurační soubor během budoucích operací.
Odpověď: Ne, restartování není nutné.
Otázka: Jaká oprávnění by měla být použita v Linuxu? Mezi příklady oprávnění patří:
mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.
Odpověď: Proces DD Boost musí být schopen číst konfigurační soubor a zapisovat jej do adresáře protokolu.
Otázka: Kde jsou protokoly BoostFS ve výchozím nastavení uloženy?
Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.
Odpověď: Tato umístění jsou oddělená od protokolů precert softwaru DD Boost.
Otázka: Jsou protokoly BoostFS a protokoly precert totéž? Protokoly BoostFS obsahují aktivitu připojení, operace systému souborů a události aplikací.
Odpověď: Ne, protokoly precert obsahují transakce rozhraní API DD Boost, komunikaci knihovny a data časování vstupně-výstupních operací.
Otázka: Jaké protokoly mám poskytnout podpoře? V závislosti na problému shromážděte ddboost_precert.log, rotované protokoly precert, protokoly BoostFS, DDPCONNCHK Výstup, protokoly aplikací a požadované balíčky podpory.
Odpověď: Poskytnutí všech relevantních protokolů pomáhá urychlit odstraňování problémů.
Otázka: Co mám dělat, pokud protokoly nejsou generovány ani po provedení tohoto KB? Shromažďujte důkazy, jako je umístění ddboost_precert.ini, výpis adresáře protokolu, DDPCONNCHK výstup, příkaz pro připojení BoostFS a informace o oprávněních.
Odpověď: Odešlete shromážděné informace technické podpoře společnosti Dell k další analýze.