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. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Poznámka: Zásuvný modul DD Boost ve výchozím nastavení nezaznamenává podrobnou aktivitu rozhraní API. Povolení protokolování před certifikátem pomocí 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: .ini 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í
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_files a log_file_size podle potřeby.
  • Protokoly lze v případě omezeného místa na disku přesměrovat na jiné místo.

Nastavení klienta Linux BOOSTFS

  1. Vytvoření /DDLog adresáře.

mkdir /DDLog

chmod 777 /DDLog

  1. Vytvoření /ddboost_precert.ini s výše uvedenou konfigurací.

 

  1. Ujistěte se, že BoostFS se odpojí a znovu připojí:

mount -o log-level=debug <mount_point>

 


Nastavení klienta Windows BOOSTFS

  1. Vytvoření C:\ddboost_precert.ini 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
  1. Vytvoření C:\DDLog a přiřaďte plná oprávnění ke čtení/zápisu.
  2. Odpojit a znovu připojit BoostFS s povoleným protokolováním ladění.

Vyčištění a zakázání protokolování

  1. Odstraňte ddboost_precert.ini nezahrnujte mezery.
  2. Odstraňte DDLog adresář a jeho obsah.
  3. Změny se projeví opětovným připojením BoostFS.
  4. 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.

    Affected Products

    Data Domain

    Products

    Data Domain
    Article Properties
    Article Number: 000020437
    Article Type: How To
    Last Modified: 21 Aug 2026
    Version:  9
    Find answers to your questions from other Dell users
    Support Services
    Check if your device is covered by Support Services.