Data Domain: Rozwiązywanie problemów z instalacją, konfiguracją i montowaniem Boostfs

BOOSTFS to składnik oprogramowania, który może być zainstalowany w niektórych systemach operacyjnych, który zapewnia możliwość uruchamiania kopii zapasowych BOOST w domenie danych bez użycia konkretnej aplikacji do tworzenia kopii zapasowych, jednocześnie wykorzystując niektóre funkcje dostępne przy użyciu aplikacji do tworzenia kopii zapasowych z obsługą BOOST, takich jak Netbackup, Networker i Avamar.

Aby uzyskać więcej szczegółowych informacji na temat instalacji i wykorzystania, sprawdź Data Domain: Przyspieszone kroki konfiguracji i szczegóły dotyczące DataDomain BOOST FS Artykuł z bazy wiedzy.

Ten artykuł bazy wiedzy zawiera jednak niektóre typowe problemy, które mogą wystąpić podczas konfigurowania i korzystania z systemu plików BOOSTFS, aby klienci mogli szybko zapoznać się z tymi typowymi błędami, komunikatami o błędach i sposobami ich rozwiązywania. Typowe takie błędy to "Nie można zainstalować Boostfs na serwerze Linux", "Montowanie Boostfs kończy się niepowodzeniem z błędem" lub "Tworzenie kopii zapasowej lub przywracanie kończy się niepowodzeniem z błędem", żeby wymienić tylko kilka.

1. Brak wymaganej zależności podczas instalowania oprogramowania

BOOST FSW przypadku niepowodzenia instalacji dostarczonego pakietu BOOSTFS RPM w systemie operacyjnym Linux klienta, należy najpierw określić, które pakiety oprogramowania są wymagane:

# rpm -qpR DDBoostFS-1.0.0.1-539441.rhel.x86_64.rpm >bezpiecznik = 2,8 biblioteki-bezpieczników >= 2.8 /pojemnik/sh /pojemnik/sh /pojemnik/sh /pojemnik/sh rpmlib(PayloadFilesHavePrefix) <= 4,0-1 rpmlib(SkompresowaneNazwyPlików) <= 3.0.4-1

W powyższym przykładzie pakiet prosi o zainstalowanie plików binarnych i bibliotek FUSE (Filesystem in USEr) (BOOSTFS jest oparty na FUSE Linuksa), a także dowolnego pakietu dostarczającego powłokę (sh) i domyślne biblioteki RPM. W związku z tym ten pakiet BOOSTFS powinien zostać zainstalowany normalnie w systemie Linux, w którym uruchomiono "rpm".


Rozdział 2. Nie można zamontować /mnt/mountpoint/: nieoczekiwany błąd

Podczas próby zamontowania zdalnej jednostki pamięci masowej DD lokalnie w kliencie Linux za pomocą BOOSTFS może pojawić się powyższy błąd. Przejrzyj plik dziennika BOOSTFS w kliencie systemu Linux. Na przykład w pierwszym poniższym przykładzie plik skrytki nie zawiera wpisu dla dd2500-abc.datadomain.com hosta:

# mniej /opt/emc/boostfs/log/ddboostfs_0_0.log Lip 29 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Nie udało się odnaleźć wpisu klucza dd2500-abc.datadomain.com:LSU2 w pliku konfiguracyjnym /opt/emc/boostfs/lockbox/boostfs.lockbox. Nie można odnaleźć żądanego wpisu skrytki. Jul 29 03:45:25 22795 3267069888 [E] bfs_conn_lookup: wyszukiwanie połączenia nie powiodło się dla pliku /.boostfs_sysinfo węzła 0. (0 kontaktów) Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: nie udało się uzyskać połączenia dla pliku /.boostfs_sysinfo Jul 29 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: inicjalizacja nie powiodła się

Rozwiązaniem w tym przypadku byłoby dodanie wpisu skrytki dla docelowego hosta DD i jednostki pamięci masowej, które mają być montowane lokalnie. Składnia byłaby podobna do poniższego przykładu:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Wprowadź hasło użytkownika jednostki pamięci masowej: Wprowadź ponownie hasło użytkownika jednostki pamięci masowej, aby potwierdzić: Zestaw wpisów skrytki

Innym możliwym błędem, który można zaobserwować w lokalnych dziennikach klienta BOOSTFS, jest to, że nazwa hosta DD nie jest rozpoznawana z klienta, na przykład:

# mniej /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_open: połączenie nie powiodło się (0 połączeń): 5037 Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_lookup: wyszukiwanie połączenia nie powiodło się dla pliku /.boostfs_sysinfo węzła 0. (0 kontaktów) Jul 29 04:05:50 22882 3322156992 [I] bfs_node_lookup: nie udało się uzyskać połączenia dla pliku /.boostfs_sysinfo Jul 29 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: inicjalizacja nie powiodła się

 
Rozwiązaniem w tym przypadku byłoby dodanie statycznego mapowania hosntame na IP do pliku /etc/host klienta Linux lub skonfigurowanie mapowania na używanym serwerze DNS.


Rozdział 3. Punkt montowania /mnt/mountpoint jest niepusty.
BoostFS nie może być zamontowany na niepustym punkcie montowania. Spróbuj zamontować na pustym punkcie montowania.

Powyższy komunikat oznacza, że określony punkt montowania (/mnt/mountpoint) nie może być użyty do wyświetlenia zdalnej jednostki pamięci masowej DD, ponieważ punkt montowania nie może mieć wcześniej zamontowanego innego systemu plików ani zawierać żadnej zawartości. /mnt/mountpoint/ musi być pustym i nieużywanym katalogiem w kliencie systemu Linux. Jeśli ścieżka ma już montowanie, należy określić inny punkt montowania. Oto przykład:

# wierzchowiec /dev/mapper/vg00-lv_root on / type ext4 (rw) /dev/sda1 na /boot Wpisz Ext4 (RW) boostfs w /mnt/mountpoint wpisz fuse.boostfs (rw,nosuid,nodev)

W takim przypadku zdalna jednostka pamięci masowej DD jest już zamontowana w /mnt/mountpoint/ i dlatego nie można jej ponownie zainstalować w tym samym katalogu.


Rozdział 4. Montaż DDBoostfs zawiesza się (powrót może potrwać nawet ponad 10 minut)

Może się tak zdarzyć, gdy zapora między klientem Linux a docelowym urządzeniem DD porzuca ruch do portów TCP 111 i 2049. Upewnij się, że klient Linux może połączyć się z DD do portów TCP 111 i 2049, a następnie spróbuj ponownie, na przykład:

# /opt/emc/boostfs//bin/boostfs mount -d dd2500.domain.com -s LSU2 /mnt/punkt montowania/

Oto przykład tego, co można zobaczyć w dziennikach BOOSTFS klienta Linux w takim przypadku:

# mniej /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_open: connect failed (0 połączeń): 5037 Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_lookup: wyszukiwanie połączenia nie powiodło się dla pliku /.boostfs_sysinfo węzła 0. (0 kontaktów) Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: nie udało się uzyskać połączenia dla pliku /.boostfs_sysinfo Jul 27 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: inicjalizacja nie powiodła się

5. Operacja niedozwolona podczas próby uzyskania dostępu do zawartości lub wyświetlenia zawartości poniżej punktu montowania

# ls -l /mnt/punkt montowania/ ls: katalog do czytania.: Operacja niedozwolona ogółem 0

Problem może polegać na braku łączności TCP ze zdalnymi portami DD 111 i 2049 lub na tym, że uwierzytelnianie skrytki w jakiś sposób wygasło. Upewnij się, że klient Linux nadal może połączyć się z DD na określonych portach, i spróbuj ponownie skonfigurować skrytkę dla zdalnego DD, jednostki pamięci masowej i użytkownika BOOST.


Rozdział 6. Niewystarczający dostęp do jednostki pamięci masowej lub nie istnieje przy użyciu uwierzytelniania Kerberos.

# boostfs mount -s LSU3 -d dd2500.domain.com /mnt/punkt_montowania/ Niewystarczający dostęp do jednostki pamięci masowej LSU3 nie istnieje

W przypadku korzystania z uwierzytelniania Kerberos dla skrytki najbardziej prawdopodobną przyczyną błędu jest wygaśnięcie biletu uwierzytelniania Kerberos. Sprawdź wspomniany bilet z Linuksa, taki jak poniżej:

# /opt/emc/boostfs/bin/boostfs kerberos query -s LSU3 -u username Zleceniodawca klienta: username@DOMAIN.COM Prawidłowe rozpoczęcie pracy: Tue Aug 23 11:02:49 2016 Wygasa: Wt sie 23 21:01:07 2016 Odnawiaj do: Wt sie 30 11:02:49 2016 Jednostka usługi: krbtgt/DOMAIN. COM@DOMAIN.COM

W DDR sprawdź, czy przypisany użytkownik BOOST do jednostki pamięci masowej jest zgodny z użytkownikiem na kliencie Linux podczas konfigurowania skrytki i montowania BOOSTFS (nazwa użytkownika AD i nazwa użytkownika jednostki pamięci masowej muszą być dokładnie takie same):

# ddboost pokaż jednostkę pamięci masowej Nazwa, stan przed kompresją (GiB), raport użytkownika, fizyczna jednostka najemcy Rozmiar (MiB) --------------- -------------- ------ -------- --------------- ----------- Nazwa użytkownika LSU3 0.0 RW - - --------------- -------------- ------ -------- --------------- -----------

Należy również upewnić się, że data/godzina w DD, kliencie Linux i serwerze Kerberos (AD) nie są oddalone od siebie o więcej niż 5 minut lub mogą wystąpić problemy z wygasłymi zgłoszeniami z powodu niespójnego czasu.

Poniżej znajduje się przykład tego, co zobaczylibyśmy w dziennikach DD, gdyby różnica czasu była większa niż 5 minut:

# debugowanie zegarka dziennika/ddfs.info 08/23 18:52:09.654 (tid 0x7f738141fb00): NFS3 zaakceptowano 3000004b6 552 z 10.64.229.125:55042 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs X3000004B6] dd_rpc_gss_print_error:117 — gss_error zdarzenia, gss_accept_sec_context nie powiodło się: maj=0xd0000, min=0x96c73a25 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 — zdarzenie gss_error, nieokreślony błąd GSS. Kod pomocniczy może dostarczyć więcej informacji 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 — gss_error zdarzenia, zbyt duże przekrzywienie zegara 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 — gss_accept_failed zdarzenia, maj=851968, min2529638949 08/23 18:52:09.660 (tid 0x7f73814233f0): NFS3 zniszczył TCP 3000004b6

A oto dzienniki hosta systemu Linux BOOSTFS:

# mniej /opt/emc/boostfs/log/ddboostfs_0_0.log Sie 23 18:04:39 1044 2019465280 [E] bfs_conn_open: connect failed (0 połączeń): 5075 23 sierpnia 18:04:39 1044 2019465280 [E] bfs_conn_lookup: wyszukiwanie połączenia nie powiodło się dla pliku /.boostfs_sysinfo węzła 0. (0 kontaktów) 23 sierpnia 18:04:39 1044 2019465280 [I] bfs_node_lookup: nie udało się uzyskać połączenia dla pliku /.boostfs_sysinfo Sie 23 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: inicjalizacja nie powiodła się

7.  Montowanie Boostfs z uwierzytelnianiem Kerberos kończy się niepowodzeniem z następującym błędem "Nie można uzyskać dostępu do skrytki lub nie można znaleźć wpisu skrytki" 

# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Nie można uzyskać dostępu do skrytki lub nie można odnaleźć wpisu skrytki

 
Jeśli zamierzasz użyć opcji konfiguracyjnych BOOSTFS w "/opt/emc/boostfs/etc/boostfs.conf", sprawdź ustawienie "[global]" w pliku i upewnij się, że nie jest ono zakomentowane (aby którakolwiek z opcji globalnych działała, słowo kluczowe "[global]" musi być odkomentowane). To słowo kluczowe jest domyślnie komentowane.

Przykładowa zawartość pliku konfiguracyjnego BOOSTFS "/opt/emc/boostfs/etc/boostfs.conf":

# Komentarze nie są dozwolone po parze wartości opcji. # ############################################################################# [Globalne] # Nazwa hosta domeny danych lub adres IP # data-domain-system=dd2500.domain.com

Przykładowe dane wyjściowe, które można zobaczyć w dziennikach BOOSTFS klienta systemu Linux:

# mniej /opt/emc/boostfs/log/ddboostfs_0_0.log Sie 24 08:23:35 27227 3565582272 [E]bfs_lockbox_get_user_info: Nie udało się odnaleźć wpisu klucza dd2500-rtp2.techsupp.local:LSU3 w pliku konfiguracyjnym /opt/emc/boostfs/lockbox/boostfs.lockbox. Nie można odnaleźć żądanego wpisu skrytki. 24 sierpnia 08:23:35 27227 3565582272 [E] bfs_conn_lookup: wyszukiwanie połączenia nie powiodło się dla pliku /.boostfs_sysinfo węzła 0. (0 kontaktów) 24 sie 08:23:35 27227 3565582272 [I] bfs_node_lookup: nie udało się uzyskać połączenia dla pliku /.boostfs_sysinfo 24 sie 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: inicjalizacja nie powiodła się

Błąd może być również wynikiem użycia innej nazwy hosta, nazwy jednostki pamięci masowej lub nazwy użytkownika BOOST w poleceniu "mount" klienta Linux w porównaniu z tymi, które zostały użyte do konfiguracji skrytki lub odpowiadają docelowemu DD. Upewnij się, że wszystkie nazwy w DD, skrytce BOOSTFS i poleceniu "mount" są zgodne.


Rozdział 8.  Próba ustawienia poświadczeń użytkownika "boostfs" kończy się niepowodzeniem z następującym błędem :

bfs_krb5_err_handler: Błąd protokołu Kerberos: -1765328360 [ERROR_MESSAGE=Nie udało się uzyskać początkowych poświadczeń.]

Nie można ustawić poświadczeń

Kerberos 1. Sprawdź, czy poświadczenia użytkownika usługi Active Directory są poprawne, logując się do kontrolera domeny przy użyciu poświadczeń użytkownika usługi Active Directory
2. Sprawdź, czy czas na kliencie Linux i serwerze Kerberos nie dzieli więcej niż 5 minut. Uwierzytelnianie Kerberos wymaga, aby czasy zegara były oddalone od siebie o nie więcej niż 5 minut.



Rozdział 9. Podczas montowania BOOSTFS w kliencie Linux kończy się to błędem "fusermount: mount failed: Eksploatacja niedozwolona."

Może to wynikać z wielu powodów. "fusermount" to podstawowe polecenie systemu Linux, które ostatecznie używa FUSE do zamontowania jednostki pamięci masowej DD BOOST lokalnie w przestrzeni nazw klienta systemu Linux. Wymaga to specjalnych uprawnień. Dlatego "fusermount" jest plikiem binarnym SUID w kliencie linuksowym:

# ls -l /usr/bin/fusermount -rwsr-xr-x. 1 root 38680 11 maja 2019 /usr/bin/fusermount

Bycie plikiem binarnym SUID oznacza, że niezależnie od tego, co użytkownik uruchomi podczas próby zamontowania jednostki pamięci masowej, "fusermount" będzie działać z uprawnieniami "root". Jeśli "fusermount" nie ma identyfikatora SUID do katalogu głównego, tylko użytkownik root klienta Linux może być w stanie zamontować zdalną jednostkę pamięci masowej BOOST. Może to nie stanowić problemu, jeśli konfigurujesz montowanie w /etc/fstab, ale może być wtedy, gdy montowanie ma być wykonane przez użytkownika innego niż root.


Rozdział 10. BOOSTFS montuje poprawnie, ale próby uzyskania dostępu do zawartości jednostki pamięci masowej w punkcie montowania kończą się niepowodzeniem z powodu błędów

uprawnieńPodczas ręcznego montażu jednostki pamięci masowej przy użyciu polecenia "boostfs" DataDomain lub /etc/fstab (lub nawet "mount.fuse" z wiersza poleceń), domyślną podstawową implementacją FUSE jest zezwolenie na dostęp tylko do identyfikatora użytkownika klienta systemu Linux, który zamontował BOOSTFS. Jeśli więc montowanie zostało wykonane jako root, tylko root może uzyskać dostęp do plików. Jeśli montowanie zostało wykonane jako użytkownik "postgres" (do tworzenia kopii zapasowej bazy danych PostgreSQL), tylko ten użytkownik będzie miał uprawnienia dostępu do plików.

Jeśli z różnych powodów potrzeba, aby inni użytkownicy mogli uzyskać dostęp do plików w zamontowanej jednostce pamięci masowej z chmury Linux, może być konieczne dostrojenie pliku /etc/fuse.conf. Zobacz więcej szczegółów tutaj:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Musisz ustawić następującą opcję w /etc/fuse.conf:

       user_allow_other
              Zezwalaj użytkownikom innym niż root na określanie opcji montowania allow_other lub allow_root (zobacz
              poniżej).
Następnie użyj następującego polecenia podczas montażu jednostki pamięci masowej BOOST z wiersza poleceń:
 

       allow_other
              Ta opcja zastępuje środek bezpieczeństwa ograniczający dostęp do plików do użytkownika
              Montowanie systemu plików.  Dzięki temu wszyscy użytkownicy (w tym root) mogą uzyskać dostęp do plików.  Tę
              opcja jest domyślnie dozwolona tylko dla roota, ale to ograniczenie można usunąć za pomocą
              Opcja konfiguracyjna opisana powyżej (user_allow_other).

 

Pytania związane z konfiguracją BOOSTFS:

1. Jaka jest maksymalna liczba sekcji punktów montowania, które można zdefiniować w pliku konfiguracyjnym boostfs?
Nie ma ograniczeń co do liczby montowań w sekcji punktu montowania pliku boostfs.conf. 

# Sekcje punktów montowania są oddzielone znacznikami [mountpoint] # # [/ścieżka/do/montowania] # [/mnt/bofs] # Nazwa hosta domeny danych lub adres IP # data-domain-system=dd2500-1.yourdomain.com # Jednostka pamięci masowej # storage-unit=su-name # Nazwa użytkownika jednostki pamięci masowej # storage-unit-username=sysadmin # Podkatalog w jednostce pamięci masowej, do której ma zostać zamontowany # nazwa-katalogu=ścieżka/do/podkatalogu

2. Networker domyślnie obsługuje BOOSTFS i może obsługiwać montowania w locie w celu wykonywania określonych zadań i kopii zapasowych

Nawet jeśli Networker jest aplikacją do tworzenia kopii zapasowych z obsługą BOOST, obsługuje również BOOSTFS w systemach klienckich Linux, w których jest zainstalowany. Przykładowa kopia zapasowa NW pobrana z wiersza poleceń klienta systemu Linux, po skonfigurowaniu skrytki BOOSTFS, może wyglądać następująco (kopia zapasowa PostgreSQL):

# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg 174908:(pid 16487):Zapisywanie danych kopii zapasowej w puli "DB". 175019:(pid 16487):Odebrano informacje wiążące zarządzanie multimediami na hoście "dd.example.com". 174910:(pid 16487):Połączono z procesem nsrmmd na hoście "dd.example.com". + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain Kontynuowane przetwarzanie ze zwróconą wartością 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/ Kontynuowane przetwarzanie ze zwróconą wartością 0. Pliki w zbiorze zapisu 'PostgreSQL_postgres_backuppostgre_full' w czasie '01/04/20 15:40:36' to: Rozmiar: Name: 2645 dump.sql 24000 postgresql.conf 2 plik(i) 26645 bajty Polecenie kopii zapasowej "/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh" zostało wykonane pomyślnie. Tworzenie kopii zapasowej zakończono pomyślnie.

Po skonfigurowaniu zadania tworzenia kopii zapasowej można je również uruchomić z graficznego interfejsu użytkownika NW i monitorować postęp tam. messages.engineering pokaże wpisy dziennika, takie jak ten poniżej, po zakończeniu montowania wydanego przez NW:

Apr 1 15:20:49 dd.example.com ddfs[17040]: UWAGA: ddboost-client.example.com-49808<>: Boostfs: Apr 1 15:22:52.395 16275 704915520 [I] Wersja wtyczki DDBoost to: [7.0.0.0.633508] Apr 1 15:20:49 dd.example.com ddfs[17040]: UWAGA: ddboost-client.example.com-49808<>: Boostfs: Apr 1 15:22:52.395 16275 704915520 [I] Informacje o wersji BoostFS: [BOOSTFS:7.0.0.0-633922 BEZPIECZNIK: 2.9.7] Apr 1 15:20:49 dd.example.com ddfs[17040]: UWAGA: ddboost-client.example.com-49808<>: Boostfs: Apr 1 15:22:52.395 16275 704915520 [I] bfs_lib_init: Montaż dd.example.com:LSU_NAME na /mnt/mountpoint