Data Domain: Włączanie rejestrowania interfejsu API DD Boost | Dzienniki precert

Summary: W tym artykule bazy wiedzy wyjaśniono, jak włączyć rejestrowanie wtyczki DD Boost podczas rozwiązywania problemów związanych z Boost i BoostFS. Jest to tzw. dziennik 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

Uwaga: Wtyczka DD Boost domyślnie nie rejestruje szczegółowej aktywności interfejsu API. Włączanie rejestrowania precert przy użyciu ddboost_precert.ini pozwala na dokładniejszą diagnostykę. Nieprawidłowe umieszczenie pliku, brak uprawnień lub błędna konfiguracja mogą uniemożliwić wygenerowanie dziennika.

Powody, dla których warto włączyć rejestrowanie na poziomie interfejsu API (przed certyfikatem):

  • Operacje DD Boost lub BoostFS kończą się niepowodzeniem lub zachowują się nieoczekiwanie.
  • Dział inżynieryjny lub pomoc techniczna żąda szczegółowych dzienników na poziomie interfejsu API do analizy.
  • Mimo oczekiwanej aktywności Boost nie są generowane żadne dzienniki.

Uwagi ogólne:

  • Rejestrowanie precert należy włączać tylko wtedy, gdy wyraźnie zażąda tego dział inżynierii lub pomocy technicznej.
  • Uważnie monitoruj miejsce na dysku; Dzienniki mogą szybko rosnąć.
  • Upewnij się, że uprawnienia i rozmieszczenie plików są prawidłowe.
  • Wymontuj .ini , aby wyłączyć rejestrowanie.
  • Aby zmiany zostały wprowadzone, należy odmontować i ponownie zamontować system BoostFS.

Lokalizacje plików według systemu operacyjnego

System operacyjny ddboost_precert.ini Lokalizacja ddboost_precert.log Lokalizacja
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

W przypadku wersji BOOST/BoostFS wcześniejszych niż 7.0

Utwórz pusty plik o nazwie ddboost_precert.ini w odpowiednim miejscu (patrz tabela powyżej). Umożliwia to logowanie do ścieżki domyślnej.


W przypadku BOOST/BoostFS w wersji 7.0 i nowszych

Utwórz skonfigurowany ddboost_precert.ini o następującej zawartości:

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
  • Ta konfiguracja tworzy cztery pliki dziennika o rozmiarze 512 MB każdy (łącznie 2 GB).
  • Dostosować num_log_files i log_file_size w razie potrzeby.
  • Dzienniki mogą być przekierowywane do innej lokalizacji, jeśli miejsce na dysku jest ograniczone.

Konfiguracja klienta Linux BOOSTFS

  1. Tworzenie /DDLog katalog:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Tworzenie /ddboost_precert.ini w powyższej konfiguracji.

  3. Upewnij się, że system BoostFS jest odmontowany i zamontowany ponownie:

    • mount -o log-level=debug <mount_point>

Konfiguracja klienta Windows BOOSTFS

  1. Tworzenie C:\ddboost_precert.ini o następującej treści:
    • 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. Tworzenie C:\DDLog i przypisz pełne uprawnienia do odczytu/zapisu.

  3. Odmontuj i ponownie zamontuj BoostFS z włączonym rejestrowaniem debugowania.


Czyszczenie i wyłączanie rejestrowania

  1. Usuń filtr ddboost_precert.ini programu NetWorker.
  2. Usuń filtr DDLog i jego zawartość.
  3. Ponownie zamontuj BoostFS, aby zastosować zmiany.
  4. Zbieranie dzienników BoostFS z /opt/emc/boostfs/log.

Additional Information

W przypadku wersji BOOST/BoostFS wcześniejszych niż 7.0 dzienniki precert są włączane przez utworzenie pustego pliku o nazwie dokładnie "ddboost_precert.ini" w lokalizacji wskazanej w poniższej tabeli. Spowoduje to, że interfejs API DD Boost SDK włączy to rejestrowanie do domyślnej lokalizacji i nazwy pliku, jak pokazano w poniższej tabeli: 

To narzędzie powinno być włączane tylko na żądanie zespołu inżynieryjnego lub zespołu pomocy technicznej, a ze względu na ilość generowanych dzienników należy zadbać o to, aby to rejestrowanie zostało jak najszybciej wyłączone.

 

System operacyjny Lokalizacja pliku ddboost_precert.ini Lokalizacja pliku ddboost_precert.log
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


W przypadku wersji BOOST i BoostFS 7.0 i nowszych plik "ddboost_precert.ini" musi zostać utworzony w tych samych lokalizacjach co powyżej, ale nie może być pusty, należy go zainicjować poniższą zawartością, w przeciwnym razie nie spowoduje to utworzenia logów :
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



Przy powyższych ustawieniach utworzy 4 pliki po 512 MB każdy, więc w sumie zajmie to tylko 2 GB miejsca na dysku.

Jeśli 4 pliki o rozmiarze 512 MB każdy nie wykraczają poza ramy czasowe wymagane do rozwiązania problemu, dostosuj liczbę plików i ich rozmiar za pomocą parametrów "num_log_files" i "log_file_size".

W przedstawionej konfiguracji dzienniki zostaną utworzone w tej samej lokalizacji co w tabeli, ale istnieje możliwość utworzenia dzienników w innej lokalizacji, jeśli partycja główna systemu operacyjnego nie jest wystarczająco duża.

NUTA: Ten folder musi znajdować się w tej samej ścieżce co plik ddboost_precert.ini (w oczekiwaniu na potwierdzenie przez kogoś, kto wie lepiej, jeśli to prawda, uniemożliwiłoby to zapisanie dziennika na jakiejś partycji innej niż typowo mały katalog główny) 


Jeśli plik .ini jest obecny (a w przypadku wersji 7.0 lub nowszej ma odpowiednią zawartość), w folderze /DDLog generowany jest plik dziennika o nazwie ddboost_precert.log (jeśli taka ścieżka jest skonfigurowana).

ddboost_precert.log może rosnąć bardzo szybko, ponieważ wszystkie wywołania interfejsu API są rejestrowane w pliku, dlatego należy zwrócić uwagę na ilość miejsca dostępnego w lokalizacji klienta na dzienniki, ponieważ mogą one spowodować zapełnienie partycji, co może spowodować przestoje i niedogodności dla klienta.

Aby zatrzymać rejestrowanie, usunięcie pliku ddboost_precert.ini spowoduje natychmiastowe zatrzymanie dzienników w skonfigurowanym pliku.
 
Wszelkie zmiany w pliku ddboost_precert.ini będą wymagały odmontowania BOOSTFS, a następnie ponownego zamontowania, aby zmiany zostały wprowadzone.
W przypadku innego oprogramowania do tworzenia kopii zapasowych, które korzysta z ddboost, ponowne uruchomienie usług może być konieczne, jeśli nie utworzono pliku dziennika w celu wykrycia obecności lub braku pliku ddboost_precert.ini
 
[1] Plik ddboost_precert.ini należy umieścić w katalogu głównym katalogu instalacyjnego.  Może być nazwany: D:\ itp.   Jeśli plik jest umieszczany na innym dysku, a plik dziennika nie został utworzony, spróbuj C:\ mimo wszystko.

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

Kroki włączania dzienników precert na serwerze

boost fps z systemem Linux1. Utwórz katalog DDLog jako /DDLog

2. Utwórz plik ddboost_precert.ini na / ścieżce o następującej zawartości
 
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

 
3. Zapisz powyższą zawartość w pliku - ddboost_precert.ini

4. Upewnij się, że katalog /DDLog ma uprawnienia do zapisu. Podaj wszystkie pliki w katalogu /DDLog.

a. zmień uprawnienia DDLog i ddboost_precert.ini
b. uruchom polecenie "sudo chmod 777 DDLog/ ddboost_precert.ini"

5. Zbierz dzienniki BoostFS poziomu debugowania.

a. Odmontuj i ponownie zamontuj punkt montowania BoostFS za pomocą opcji "-o log-level=debug"
b. Można również zaktualizować poziom dziennika w pliku boostfs.conf w katalogu /opt/emc/boostfs/etc. Nadal będzie konieczne odmontowanie i zamontowanie dysku BoostFS.
c. Wykonaj operację tworzenia kopii zapasowej w punkcie montowania BoostFS.
d. Podaj wszystkie pliki w katalogu — /opt/emc/boostfs/log


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

Włącz dzienniki precert na serwerze

Windows BoostFS 1. Utwórz ddboost_precert.ini w obszarze C:  dysk o następującej treści:

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. Utwórz folder o nazwie DDLog na dysku C:. W tym folderze zostaną utworzone pliki dziennika precert. Podaj wszystkie uprawnienia do odczytu/zapisu do katalogu DDLog, aby można było tworzyć i dołączać pliki dziennika.


NUTA:
Powyższa konfiguracja spowoduje utworzenie maksymalnie 3 plików dziennika precert o wielkości około 500 MB każdy.
Dla num_log_files i log_file_size można stosować różne wartości, jeśli uzna się to za stosowne.  Ale 3 pliki po 500 MB każdy powinny wystarczyć do celu.
Jeśli 1,5 GB wolnego miejsca w systemie klienckim nie jest możliwe, wartość log_file_size można zmniejszyć do 200.
Przed włączeniem dzienników precert upewnij się, że w systemie klienckim jest wystarczająca ilość miejsca na dysku.

3. Odmontuj i ponownie zamontuj punkt montowania BoostFS za pomocą opcji "-o log-level=debug"


Działanie czyszczenia i wyłączanie rejestrowania

przed certyfikatemPo zebraniu dzienników precert po wystąpieniu problemu wyłącz rejestrowanie precert, wykonując następujące czynności.  Należy to zrobić przed ponownym zamontowaniem BoostFS SU.
1. Usuń folder DDLog z C: i jego zawartość
2. Usuń ddboost_precert.ini plik z C:



=====================================================================================================Włącz dzienniki precert na serwerze Linux za pomocą aplikacji do tworzenia kopii zapasowych ddboost.

Procedura włączania logowania DDBoost Precert na serwerze DDBoost z systemem Linux: 

Utwórz katalog /DDLog

2. Przyznaj wszystkim użytkownikom uprawnienia do katalogu /DDLog przy użyciu następującego polecenia:

       $ chmod 777 /DDLog

3. Utwórz plik /ddboost_precert.ini o następującej zawartości:

       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

4. Dzienniki precert będą generowane w katalogu /DDLog.
=======================================================================================


Włącz dzienniki precert w systemie Windows Server za pomocą aplikacji do tworzenia kopii zapasowych ddboost.  

1. Utwórz ddboost_precert.ini w obszarze C:  dysk o następującej treści:

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. Utwórz folder o nazwie DDLog na dysku C:. W tym folderze zostaną utworzone pliki dziennika precert. Podaj wszystkie uprawnienia do odczytu/zapisu do katalogu DDLog, aby można było tworzyć i dołączać pliki dziennika.


NUTA:
Powyższa konfiguracja spowoduje utworzenie maksymalnie 3 plików dziennika precert o wielkości około 500 MB każdy.
Dla num_log_files i log_file_size można stosować różne wartości, jeśli uzna się to za stosowne.  Ale 3 pliki po 500 MB każdy powinny wystarczyć do celu.
Jeśli 1,5 GB wolnego miejsca w systemie klienckim nie jest możliwe, wartość log_file_size można zmniejszyć do 200.
Przed włączeniem dzienników precert upewnij się, że w systemie klienckim jest wystarczająca ilość miejsca na dysku.
 

Działanie czyszczenia i wyłączanie rejestrowania

przed certyfikatemPo zebraniu dzienników precert po wystąpieniu problemu wyłącz rejestrowanie precert, wykonując następujące czynności. 
1. Usuń folder DDLog z C: i jego zawartość
2. Usuń ddboost_precert.ini plik 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.