Data Domain: Włączanie rejestrowania interfejsu API DD Boost — dzienniki Precert

Summary: W tym artykule wyjaśniono, jak włączyć rejestrowanie wtyczki Data Domain Boost (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 Umiejscowienie ddboost_precert.log Umiejscowienie
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 i BoostFS wcześniejszych niż 7.0

Utwórz 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 i BoostFS w wersji 7.0 lub nowszej

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).
  • Możliwość regulacji num_log_files i log_file_size zgodnie z wymaganiami.
  • Dzienniki mogą być przekierowywane do innej lokalizacji, jeśli miejsce na dysku jest ograniczone.

Konfiguracja klienta Linux BOOSTFS

  1. Utwórz /DDLog .

mkdir /DDLog

chmod 777 /DDLog

  1. Utwórz /ddboost_precert.ini w powyższej konfiguracji.

 

  1. Upewnij się, że System BoostFS jest odmontowany i zamontowany ponownie:

mount -o log-level=debug <mount_point>

 


Konfiguracja klienta Windows BOOSTFS

  1. Utwórz 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
  1. Utwórz C:\DDLog i przypisz pełne uprawnienia do odczytu/zapisu.
  2. Zdemontuj i ponownie zamontuj BoostFS z włączonym rejestrowaniem debugowania.

Czyszczenie i wyłączanie rejestrowania

  1. Usuń filtr ddboost_precert.ini .
  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

Często zadawane pytania (FAQ)

    Pytanie: Co to jest rejestrowanie DD Boost Precert? Rejestrowanie DD Boost Precert to funkcja rejestrowania diagnostycznego, która rejestruje transakcje interfejsu API DD Boost między klientem DD Boost a systemem Data Domain.
    Odpowiedź: Jest ona często używana do rozwiązywania problemów z wydajnością, awariami, opóźnieniami i problemami z komunikacją.

    Pytanie: Co rejestruje rejestrowanie Precert? Rejestrowanie Precert przechwytuje aktywność interfejsu API DD Boost, w tym operacje odczytu, operacje zapisu, aktywność tworzenia kopii zapasowych, aktywność przywracania, interakcje z biblioteką DD Boost, informacje o czasie wywołań interfejsu API i wskaźniki opóźnień po stronie klienta.
    Odpowiedź: Zapewnia szczegółowy wgląd w zachowanie interfejsu API DD Boost na potrzeby rozwiązywania problemów i analizy wydajności.

    Pytanie: Dlaczego nie są generowane żadne dzienniki precert? Sprawdź, czy plik ddboost_precert.ini istnieje, czy znajduje się w katalogu głównym systemu operacyjnego, czy katalog dziennika istnieje, czy umożliwia zapis i czy została uruchomiona nowa operacja tworzenia kopii zapasowej lub przywracania.
    Odpowiedź: Najczęstsze przyczyny to brak konfiguracji, nieprawidłowe rozmieszczenie, problemy z uprawnieniami lub brak nowej aktywności DD Boost.

    Pytanie: Czy włączenie rejestrowania precert natychmiast generuje dzienniki? Konfiguracja umożliwia tylko rejestrowanie.
    Odpowiedź: Nie, pliki dziennika są generowane tylko po otrzymaniu nowych żądań interfejsu API DD Boost.

    Pytanie: Dlaczego moja aktualnie uruchomiona kopia zapasowa nie generuje dzienników precert? Rejestrowanie Precert przechwytuje tylko aktywność interfejsu API zainicjowaną po wykryciu konfiguracji.
    Odpowiedź: Istniejące zadania tworzenia kopii zapasowych lub przywracania są kontynuowane bez generowania dzienników precert.

    Pytanie: Czy trzeba ponownie wykonać zadanie tworzenia kopii zapasowej lub przywracania danych? Jeśli zadanie było już uruchomione w momencie włączenia rejestrowania, rozpocznij nową operację.
    Odpowiedź: Tak, do wygenerowania dzienników precert wymagane jest nowe zadanie tworzenia kopii zapasowej lub przywracania.

    Pytanie: Jaki jest najczęstszy powód, dla którego rejestrowanie precert nie działa? Typowe przyczyny to: ddboost_precert.ini nie będąc na poziomie głównym, przypadkowo nazwany ddboost_precert.ini.txt, brakujący katalog dziennika lub niewystarczające uprawnienia.
    Odpowiedź: Najczęstszymi przyczynami są problemy z konfiguracją i systemem plików.

    Pytanie: Gdzie należy umieścić plik ddboost_precert.ini? 

    Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.

    Odpowiedź: Plik musi znajdować się w katalogu głównym systemu operacyjnego.

    Pytanie: Czy plik ddboost_precert.ini można zapisać w innym folderze? Wtyczka DD Boost sprawdza tylko katalog główny systemu operacyjnego.
    Odpowiedź: Nie, plik musi być przechowywany w katalogu głównym.

    Pytanie: Jak mogę sprawdzić, czy plik nie jest w rzeczywistości

    ddboost_precert.ini.txt

    Otwórz Eksplorator plików, włącz rozszerzenia nazw plików i zweryfikuj nazwę pliku.
    Odpowiedź: Upewnij się, że plik ma nazwę 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Pytanie: Dlaczego jest DDLog Katalog pusty po włączeniu logowania? Możliwe przyczyny to brak nowej aktywności DD Boost, problemy z uprawnieniami lub plik konfiguracyjny, który nie został wykryty.
    Odpowiedź: Uruchamianie nowej kopii zapasowej, przywracanie lub DDPCONNCHK Przetestuj, aby wygenerować aktywność.

    Pytanie: Co to jest DDPCONNCHK I dlaczego jest to przydatne? DDPCONNCHK to narzędzie do sprawdzania poprawności łączności DD Boost.
    Odpowiedź: Może generować aktywność interfejsu API DD Boost i szybko potwierdzać, że rejestrowanie precert działa.

    Pytanie: Puszka DDPCONNCHK może być użyty do przetestowania mojej konfiguracji? Inżynierowie często biegają DDPCONNCHK po włączeniu logowania.
    Odpowiedź: Tak, jest to powszechny sposób sprawdzania, czy dzienniki są generowane przed odtworzeniem problemu.

    Pytanie: Dlaczego moje dzienniki precert rosną tak szybko? Rejestrowanie Precert rejestruje każde wywołanie interfejsu API DD Boost.
    Odpowiedź: Duże środowiska tworzenia kopii zapasowych mogą w krótkim czasie wygenerować znaczną ilość dzienników.

    Pytanie: Ile miejsca na dysku powinienem przydzielić? Powszechnym zaleceniem jest 

    num_log_files=3 and log_file_size=500.

    Odpowiedź: Zapewnia to około 1,5 GB miejsca do magazynowania dzienników przed rotacją.

    Pytanie: Czy dzienniki precert mogą wypełniać system plików? Rejestrowanie może zajmować znaczną ilość miejsca na dysku, jeśli nie jest monitorowane.
    Odpowiedź: Tak, zapełnione systemy plików mogą powodować awarie kopii zapasowych, przestoje i przerwy w świadczeniu usług.

    Pytanie: Jaki jest cel num_log_files? Ten parametr steruje liczbą przechowywanych obróconych plików dziennika.
    Odpowiedź: Na przykład:, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Pytanie: Jaki jest cel log_file_size? Ten parametr określa maksymalny rozmiar każdego pliku dziennika w MB.
    Odpowiedź: Na przykład log_file_size=500 pozwala na zwiększenie rozmiaru każdego pliku do 500 MB przed obróceniem.

    Pytanie: Co łanias ddcl_logs_include=true Należy: Umożliwia włączenie informacji o rejestrowaniu biblioteki klienta DD Boost w dziennikach precert.
    Odpowiedź: Zalecane ustawienie to ddcl_logs_include=true.

    Pytanie: Co robi ddcl_logs_sev=4 Znaczenie Ten parametr steruje poziomem istotności rejestrowania.
    Odpowiedź: Poziom ważności 4 zapewnia szczegółowe informacje dotyczące rozwiązywania problemów i debugowania.

    Pytanie: Czy muszę BoostFS Debugowanie rejestrowania oprócz rejestrowania precert? Dodatkowe rejestrowanie nie zawsze jest wymagane.
    Odpowiedź: Dla BoostFS-specific problemy, włączenie obu często zapewnia pełniejszy obraz diagnostyczny.

    Pytanie: Dla BoostFS, czy muszę zdemontować i ponownie zamontować? Odmontowanie i ponowne zamontowanie powoduje ponowne zainicjowanie aktywności BoostFS.
    Odpowiedź: W wielu przypadkach tak, pomaga to zainicjować nowe działanie DD Boost.

    Pytanie: Jaka jest prawidłowa składnia rejestrowania debugowania BoostFS? Prawidłowa składnia to -o log-level=debug.
    Odpowiedź: Nie używać --o log-level=debug ponieważ tylko jeden myślnik jest prawidłowy.

    Pytanie: Dlaczego ponowna instalacja BoostFS nagle spowodowała pojawienie się dzienników precert? Ponowny montaż tworzy nowy cykl inicjalizacji systemu plików BoostFS.
    Odpowiedź: Rejestrowanie rozpoczyna się, gdy wystąpi nowa aktywność interfejsu API DD Boost i wtyczka wykryje plik konfiguracyjny.

    Pytanie: Czy ponowne uruchomienie aplikacji jest równoznaczne z ponownym zamontowaniem BoostFS? Każde działanie, które tworzy nową aktywność interfejsu API DD Boost, może wywołać rejestrowanie.
    Odpowiedź: Zazwyczaj tak, przykłady obejmują ponowne uruchomienie RMAN, oprogramowanie do tworzenia kopii zapasowych lub uruchomione DDPCONNCHK.

    Pytanie: Puszka RMAN generować dzienniki precert bez odmontowywania BoostFS? RMAN może bezpośrednio inicjować nowe żądania API DD Boost.
    Odpowiedź: Tak, rozpoczęcie nowej RMAN operacja jest zwykle wystarczająca.

    Pytanie: Jak wyłączyć rejestrowanie precert? Usuń ddboost_precert.ini lub zmień jego nazwę na ddboost_precert.ini.disabled.
    Odpowiedź: Rejestrowanie jest aktywowane tylko wtedy, gdy dokładna nazwa pliku ddboost_precert.ini Istniejące

    Pytanie: Czy po usunięciu pliku ini trzeba ponownie uruchomić hosta? Wtyczka sprawdza dostępność pliku konfiguracyjnego podczas przyszłych operacji.
    Odpowiedź: Nie, ponowne uruchomienie nie jest wymagane.

    Pytanie: Jakich uprawnień należy używać w systemie Linux? Przykładowe uprawnienia obejmują: 

    mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.

    Odpowiedź: Proces DD Boost musi być w stanie odczytać plik konfiguracyjny i zapisać go w katalogu dziennika.

    Pytanie: Gdzie są domyślnie przechowywane dzienniki BoostFS? 

    Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.

    Odpowiedź: Lokalizacje te są oddzielone od dzienników precert DD Boost.

    Pytanie: Czy dzienniki BoostFS i dzienniki precert to to samo? Dzienniki BoostFS zawierają aktywność instalacji, operacje systemu plików i zdarzenia aplikacji.
    Odpowiedź: Nie, dzienniki precert zawierają transakcje interfejsu API DD Boost, komunikację z biblioteką i dane chronometrażu we/wy.

    Pytanie: Jakie dzienniki należy przekazać działowi pomocy technicznej? W zależności od problemu zbierz ddboost_precert.log, obrócone dzienniki precert, dzienniki BoostFS, DDPCONNCHK Dane wyjściowe, dzienniki aplikacji i żądane pakiety pomocy technicznej.
    Odpowiedź: Dostarczenie wszystkich istotnych dzienników pomaga przyspieszyć rozwiązywanie problemów.

    Pytanie: Co należy zrobić, jeśli po wykonaniu tych czynności z bazy wiedzy dzienniki nadal nie są generowane? Zbierz dowody, takie jak lokalizacja ddboost_precert.ini, katalog dziennika, DDPCONNCHK dane wyjściowe, polecenie montowania BoostFS i informacje o uprawnieniach.
    Odpowiedź: Prześlij zebrane informacje do działu pomocy technicznej firmy Dell do dalszej analizy.

    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.