Data Domain: Povolení protokolování rozhraní API funkce DD Boost | Protokoly předběžného certifikátu

Shrnutí: 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. ...

Tento článek se vztahuje na Tento článek se nevztahuje na Tento článek není vázán na žádný konkrétní produkt. V tomto článku nejsou uvedeny všechny verze produktu.

Pokyny

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 .ini soubor 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_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ář:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Vytvoření /ddboost_precert.ini s výše uvedenou konfigurací.

  3. Ujistěte se, že je BoostFS odpojen a znovu připojen:

    • 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
  2. Vytvoření C:\DDLog a přiřaďte plná oprávnění ke čtení/zápisu.

  3. Odpojte a znovu připojte 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 .
  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.

Další informace

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.
 
Jakákoli změna souboru ddboost_precert.ini bude vyžadovat, aby se BOOSTFS odpojil a znovu připojil, aby se změny projevily.
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
 
[1] Soubor ddboost_precert.ini musí být umístěn v kořenovém adresáři instalačního adresáře.  Může být pojmenován: D:\ atd.   Pokud soubor umístíte na jinou jednotku a nevytvoří se žádný soubor protokolu, přesto zkuste C:\.

=====================================================================================================

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:

Dotčené produkty

Data Domain

Produkty

Data Domain
Vlastnosti článku
Číslo článku: 000020437
Typ článku: How To
Poslední úprava: 10 lis 2025
Verze:  7
Najděte odpovědi na své otázky od ostatních uživatelů společnosti Dell
Služby podpory
Zkontrolujte, zda se na vaše zařízení vztahují služby podpory.