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.
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
.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_filesilog_file_sizew razie potrzeby. - Dzienniki mogą być przekierowywane do innej lokalizacji, jeśli miejsce na dysku jest ograniczone.
Konfiguracja klienta Linux BOOSTFS
- Tworzenie
/DDLogkatalog:mkdir /DDLogchmod 777 /DDLog
-
Tworzenie
/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
- Tworzenie
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
-
-
Tworzenie
C:\DDLogi przypisz pełne uprawnienia do odczytu/zapisu. -
Odmontuj i ponownie zamontuj BoostFS z włączonym rejestrowaniem debugowania.
Czyszczenie i wyłączanie rejestrowania
- Usuń filtr
ddboost_precert.iniprogramu NetWorker. - Usuń filtr
DDLogi jego zawartość. - Ponownie zamontuj BoostFS, aby zastosować zmiany.
- 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.
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
=====================================================================================================
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: