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.
Instructions
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
.iniAby 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_filesilog_file_sizezgodnie z wymaganiami. - Dzienniki mogą być przekierowywane do innej lokalizacji, jeśli miejsce na dysku jest ograniczone.
Konfiguracja klienta Linux BOOSTFS
- Utwórz
/DDLog.
mkdir /DDLog
chmod 777 /DDLog
- Utwórz
/ddboost_precert.iniw powyższej konfiguracji.
- Upewnij się, że System BoostFS jest odmontowany i zamontowany ponownie:
mount -o log-level=debug <mount_point>
Konfiguracja klienta Windows BOOSTFS
- Utwórz
C:\ddboost_precert.inio 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
- Utwórz
C:\DDLogi przypisz pełne uprawnienia do odczytu/zapisu. - Zdemontuj i ponownie zamontuj BoostFS z włączonym rejestrowaniem debugowania.
Czyszczenie i wyłączanie rejestrowania
- Usuń filtr
ddboost_precert.ini. - Usuń filtr
DDLogi jego zawartość. - Ponownie zamontuj BoostFS, aby zastosować zmiany.
- 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.