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

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

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

Affected Products

Data Domain

Products

Data Domain
Article Properties
Article Number: 000020437
Article Type: How To
Last Modified: 10 Nov 2025
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.