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

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

Denne artikkelen gjelder for Denne artikkelen gjelder ikke for Denne artikkelen er ikke knyttet til noe bestemt produkt. Det er ikke produktversjonene som identifiseres i denne artikkelen.

Instruksjoner

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.

Tilleggsinformasjon

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.

    Berørte produkter

    Data Domain

    Produkter

    Data Domain
    Artikkelegenskaper
    Artikkelnummer: 000020437
    Artikkeltype: How To
    Sist endret: 21 aug. 2026
    Versjon:  9
    Få svar på spørsmålene dine fra andre Dell-brukere
    Støttetjenester
    Sjekk om enheten din er dekket av støttetjenestene.