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

Podsumowanie: Ten artykuł pomaga użytkownikowi zidentyfikować i rozwiązać niektóre typowe problemy z instalacją i konfiguracją BOOSTFS.

Ten artykuł dotyczy Ten artykuł nie dotyczy Ten artykuł nie jest powiązany z żadnym konkretnym produktem. Nie wszystkie wersje produktu zostały zidentyfikowane w tym artykule.
Sprawdź inne zasoby

Instrukcje

BoostFS to składnik oprogramowania, który może być instalowany w niektórych systemach operacyjnych. Umożliwia on uruchamianie kopii zapasowych DD Boost w Data Domain bez korzystania z konkretnej aplikacji do tworzenia kopii zapasowych, a także wykorzystuje niektóre funkcje dostępne przy użyciu aplikacji do tworzenia kopii zapasowych z obsługą Boost, takich jak NetBackup, NetWorker lub Avamar.
 
Aby uzyskać więcej szczegółowych informacji na temat instalacji i wykorzystania, sprawdź Data Domain: Przyspieszenie konfiguracji systemu plików Data Domain Boost File System.
 
Ta baza wiedzy zawiera jednak niektóre typowe problemy, które mogą wystąpić podczas konfigurowania i korzystania z BoostFS. Służy jako szybkie odniesienie do typowych błędów, komunikatów o błędach i sposobów ich rozwiązywania. Typowe tego typu błędy to "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error," lub "Backup or restore fails with error", by wymienić tylko kilka.
 

Typowe problemy z BoostFS

  1. Brak wymaganej zależności podczas instalowania oprogramowania BoostFS
Jeśli nie można zainstalować dostarczonego pakietu BoostFS RPM w systemie operacyjnym Linux klienta, należy najpierw określić, które są wymagane zależności pakietów dla oprogramowania BoostFS:
# rpm -qpR DDBoostFS-1.0.0.1-539441.rhel.x86_64.rpm
fuse >= 2.8
fuse-libs >= 2.8
/bin/sh
/bin/sh
/bin/sh
/bin/sh
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(CompressedFileNames) <= 3.0.4-1
 
W powyższym przykładzie pakiet prosi o FUSE ("Filesystem in USEr space") pliki binarne i biblioteki do zainstalowania (BoostFS jest oparty na systemie Linux FUSE), a także wszelkie pakiety zawierające powłokę (sh) i domyślne biblioteki RPM. Dlatego ten pakiet BoostFS powinien zainstalować normalnie w systemie Linux "rpm" został uruchomiony.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
Powyższy błąd może wystąpić podczas próby zamontowania zdalnej jednostki pamięci masowej Data Domain lokalnie w kliencie Linux za pośrednictwem systemu plików BoostFS. Przejrzyj plik dziennika BoostFS w kliencie z systemem Linux. Na przykład w pierwszym przykładzie poniżej plik skrytki nie zawiera wpisu dla hosta data.domain.com: 
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Jul 29 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Failed to find key entry data.domain.com:LSU2 in config file /opt/emc/boostfs/lockbox/boostfs.lockbox. The requested Lockbox entry could not be found.
Jul 29 03:45:25 22795 3267069888 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Jul 29 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: initialization failed
 
Rozwiązaniem w tym przypadku jest dodanie wpisu skrytki dla docelowego hosta Data Domain 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 data.domain.com -s LSU2
Enter storage unit user password:
Enter storage unit user password again to confirm:
Lockbox entry set
 
Innym możliwym błędem, który można zaobserwować w lokalnych dziennikach klienta BoostFS, jest to, że nazwa hosta Data Domain nie jest rozpoznawana z klienta. Na przykład:
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_open: connect failed (0 connections): 5037
Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Jul 29 04:05:50 22882 3322156992 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Jul 29 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: initialization failed
 
Rozwiązaniem w tym przypadku jest dodanie statycznej nazwy hosta do mapowania IP do klienta Linux /etc/host lub skonfigurować mapowanie na używanym serwerze DNS.
 
  1. The mount point /mnt/mountpoint is nonempty.
BoostFS cannot be mounted on a nonempty mount point. Please try mounting on an empty mount point.
 
Powyższy komunikat oznacza, że określony punkt montowania (/mnt/mountpoint) nie może być użyta do pokazania zdalnej jednostki pamięci masowej Data Domain, 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, określ inny punkt montowania. Na przykład: 
# mount /dev/mapper/vg00-lv_root on / type ext4 (rw) /dev/sda1 on /boot type ext4 (rw) boostfs on /mnt/mountpoint type fuse.boostfs (rw,nosuid,nodev)
 
W takim przypadku zdalna jednostka pamięci masowej Data Domain jest już zamontowana w /mnt/mountpoint/ i dlatego nie może być ponownie zamontowany w tym samym katalogu.
 
  1. Uchwyt montażowy BoostFS przestaje reagować (powrót może potrwać nawet dłużej niż 10 minut)
Może się tak zdarzyć, gdy zapora między klientem systemu Linux a docelowym urządzeniem Data Domain porzuca ruch do portów TCP 111 i 2049. Sprawdź, czy klient systemu Linux może połączyć się z Data Domain na portach TCP 111 i 2049, a następnie spróbuj ponownie. Na przykład:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Oto przykład tego, co w takim przypadku pojawiłoby się w dziennikach BoostFS klienta systemu Linux:
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_open: connect failed (0 connections): 5037
Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Jul 27 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: initialization failed
 
  1. ”Operation not permitted" podczas próby uzyskania dostępu do zawartości lub wyświetlenia zawartości poniżej punktu montowania
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Problem może polegać na braku łączności TCP ze zdalnymi portami Data Domain 111 i 2049 lub wygaśnięciu uwierzytelniania skrytki. Sprawdź, czy klient systemu Linux nadal może połączyć się z Data Domain na określonych portach, i spróbuj ponownie skonfigurować skrytkę dla zdalnego Data Domain, jednostki pamięci masowej i użytkownika DD Boost.
 
  1. ”Insufficient access to or storage-unit does not exist" podczas korzystania z uwierzytelniania Kerberos
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
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, jak poniżej:
# /opt/emc/boostfs/bin/boostfs kerberos query -s LSU3 -u username
Client Principal: username@DOMAIN.COM
Valid Starting: Tue Aug 23 11:02:49 2016
Expires: Tue Aug 23 21:01:07 2016
Renew Until: Tue Aug 30 11:02:49 2016
Service Principal: krbtgt/DOMAIN.COM@DOMAIN.COM
 
W Data Domain podczas konfigurowania skrytki i montażu systemu plików BoostFS należy sprawdzić, czy użytkownik DD Boost przypisany do jednostki pamięci masowej jest zgodny z użytkownikiem na kliencie Linux. Nazwa użytkownika AD i nazwa użytkownika jednostki pamięci masowej muszą być identyczne:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Upewnij się również, że daty i godziny w Data Domain, kliencie Linux i na serwerze Kerberos (AD) nie są oddalone od siebie o więcej niż 5 minut. Problemy z biletami, które wygasły z powodu niespójnego czasu, mogą wystąpić, jeśli są zbyt daleko od siebie.
 
Poniżej znajduje się przykład tego, co pojawiłoby się w dziennikach Data Domain, gdyby czas różnił się o więcej niż 5 minut:
# log watch debug/ddfs.info
08/23 18:52:09.654 (tid 0x7f738141fb00): nfs3 accepted 3000004b6 552 from 10.10.10.10:55042
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:117 - event gss_error, gss_accept_sec_context failed: maj=0xd0000, min=0x96c73a25
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 - event gss_error, Unspecified GSS failure. Minor code may provide more information
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 - event gss_error, Clock skew too great
08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 - event gss_accept_failed, maj=851968, min2529638949
08/23 18:52:09.660 (tid 0x7f73814233f0): nfs3 destroyed tcp 3000004b6
 
Są to dzienniki hosta systemu Linux BoostFS:
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_open: connect failed (0 connections): 5075
Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Aug 23 18:04:39 1044 2019465280 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Aug 23 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: initialization failed
 
  1. Montowanie BoostFS z uwierzytelnianiem Kerberos kończy się niepowodzeniem z błędem "Not able to access lockbox or lockbox entry cannot be found”
# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Not able to access lockbox or lockbox entry cannot be found
 
Jeśli zamierzasz korzystać z opcji konfiguracyjnych BoostFS w "/opt/emc/boostfs/etc/boostfs.conf", sprawdź "[global]" w pliku i upewnij się, że nie jest ono zakomentowane. Słowo kluczowe "[global]" jest domyślnie komentowana i musi zostać usunięta z komentarza, aby którakolwiek z opcji globalnych działała.
 
Przykładowa zawartość BoostFS "/opt/emc/boostfs/etc/boostfs.conf" plik konfiguracyjny: 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Przykładowe dane wyjściowe z dzienników BoostFS klienta systemu Linux:
# less /opt/emc/boostfs/log/ddboostfs_0_0.log
Aug 24 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Failed to find key entry datadomain.techsupp.local:LSU3 in config file /opt/emc/boostfs/lockbox/boostfs.lockbox. The requested Lockbox entry could not be found.
Aug 24 08:23:35 27227 3565582272 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 connections)
Aug 24 08:23:35 27227 3565582272 [I] bfs_node_lookup: failed to obtain a connection for file /.boostfs_sysinfo
Aug 24 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: initialization failed
 
Błąd może być również wynikiem użycia innej nazwy hosta, nazwy jednostki pamięci masowej lub nazwy użytkownika DD Boost w kliencie Linux"mount", w porównaniu z tymi, które zostały użyte do skonfigurowania skrytki lub odpowiadają docelowej Data Domain. Upewnij się, że wszystkie nazwy są zgodne w Data Domain, skrytce BoostFS i "mount" polecenie.
 
  1. Próby ustawienia "boostfs" poświadczenia użytkownika kończą się niepowodzeniem z następującym błędem:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
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.
 
  1. Montaż BoostFS w kliencie Linux kończy się niepowodzeniem z błędem "fusermount: mount failed: Operation not permitted.”
Może to wynikać z jednego z kilku powodów. ”fusermount" to podstawowe polecenie Linuksa, które ostatecznie używa FUSE , aby zainstalować jednostkę pamięci masowej DD Boost lokalnie w przestrzeni nazw klienta Linux. Wymaga to specjalnych uprawnień. Dlatego "fusermount" to plik binarny SUID w kliencie systemu Linux: 
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
Bycie plikiem binarnym SUID oznacza, że niezależnie od tego, który użytkownik podejmuje próbę zamontowania jednostki pamięci masowej, "fusermount" działa z "root" przywileje. Jeśli "fusermount" nie jest identyfikatorem SUID root, tylko klient systemu Linux root użytkownik może zamontować zdalną jednostkę pamięci masowej BOOST. Może to nie stanowić problemu, jeśli konfiguracja uchwytu pod /etc/fstab, ale miałoby to miejsce, gdybyroot Użytkownik musi wykonać montaż.
 
  1. BoostFS montuje się 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ń
W przypadku ręcznego montażu jednostki pamięci masowej przy użyciu Data Domain "boostfs" lub /etc/fstab (lub nawet "mount.fuse" z wiersza poleceń), jest to domyślny FUSE implementacja, aby zezwolić tylko na dostęp do plików do klienta Linux userid 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 uchwyt został wykonany 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 inni użytkownicy muszą mieć dostęp do plików w zamontowanej jednostce pamięci masowej z chmury Linux, /etc/fuse.conf może wymagać dostrojenia. Więcej szczegółów można znaleźć tutaj: Ubuntu Manpage: bezpiecznikKliknięcie tego hiperłącza powoduje wyświetlenie strony spoza witryny Dell Technologies.
 
Ustaw następującą opcję w /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Następnie użyj następującego polecenia podczas montażu jednostki pamięci masowej BOOST z wiersza poleceń:
allow_other
       This option overrides the security measure restricting file access to the user mounting the filesystem.
       So all users (including root) can access the files. This option is by default only allowed to root, but
       this restriction can be removed with the configuration option described above (user_allow_other).
 
  1. BoostFS nie obsługuje uwierzytelniania jednokierunkowego ani dwukierunkowego przy użyciu certyfikatów. Użyj two-way-password .
Aug  1 15:46:39.436 4632 1188 [I] [ddp log] [1218:4A4] number of sslquery 1
Aug  1 15:46:39.436 4632 1188 [E] [ddp log] [1218:4A4] number of ssl_query_failed2 = 1
 
  1. Jeśli podczas montażu jednostki pamięci masowej wystąpią błędy z protokołem SSL, sprawdź, czy sieć nie zmniejsza wartości MTU między klientem a Data Domain.
  2. Upewnij się, że system Data Domain nie jest skonfigurowany do wymagania uwierzytelniania jednokierunkowego lub dwukierunkowego przy użyciu certyfikatów. 
    # ddboost option show
Option                           Value
------------------------------   -------
distributed-segment-processing   enabled
virtual-synthetics               enabled
global-authentication-mode       two-way
global-encryption-strength       medium
------------------------------   -------

# ddboost clients show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        medium**                two-way
------   -------------------   -------------------
(**) The global security settings take precedence over these client(s) specific settings.
  3. Zapytaj klienta, czy może zmienić konfigurację na two-way-password lub none. 
    ddboost option set global-authentication-mode none global-encryption-strength {none | medium | high}

or

ddboost option set global-authentication-mode two-way-password global-encryption-strength {medium | high}
  4. Jeśli klienci muszą być również jednokierunkowi lub dwukierunkowi, należy to również zmienić, aby umożliwić montowanie BoostFS do Data Domain. Poproś o pozwolenie na wybór którejś z poniższych zmian. Jeśli bieżące ustawienia w Data Domain to zarówno "none", nie trzeba wprowadzać żadnych zmian. Przejdź do testowania montażu BoostFS. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Opcja 1: Zmodyfikuj ich istniejącą konfigurację, aby używać two-way-password i istniejącą siłę szyfrowania. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Opcja 2: Dodaj nowego klienta dla bieżącego klienta montowania BoostFS. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Dodatkowe informacje

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 boostfs.conf programu NetWorker. 
# Mount point sections are separated by [mountpoint] tags
#

# [/path/to/mount]
# [/mnt/bofs]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com

# Storage Unit
# storage-unit=su-name

# Storage Unit Username
# storage-unit-username=sysadmin

# Subdirectory within the storage-unit to mount to
# directory-name=path/to/subdir
 
  1. Czy NetWorker obsługuje BoostFS?
NetWorker domyślnie obsługuje BoostFS i może obsługiwać montowanie w locie w celu wykonywania określonych zadań i tworzenia kopii zapasowych.
 
Mimo że NetWorker jest aplikacją do tworzenia kopii zapasowych z obsługą DD Boost, obsługuje również BoostFS w systemach klienckich Linux, w których jest zainstalowana. Przykładowa kopia zapasowa NetWorker pobrana z wiersza poleceń klienta systemu Linux, po skonfigurowaniu skrytki BoostFS, może być następująca (kopia zapasowa PostgreSQL):
# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg
174908:(pid 16487):Saving the backup data in the pool 'DB'.
175019:(pid 16487):Received the media management binding information on the host 'dd.example.com'.
174910:(pid 16487):Connected to the nsrmmd process on the host 'dd.example.com'. + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain
Continued processing with the returned value 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/
Continued processing with the returned value 0.
The files in the save set 'PostgreSQL_postgres_backuppostgre_full' at time '01/04/20 15:40:36' are:
               Size:   Name:
			    2645   dump.sql
			   24000   postgresql.conf
			    2 File(s)       26645 bytes
The backup command '/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh' completed successfully.
The backup completed successfully.
 
Po skonfigurowaniu zadania tworzenia kopii zapasowej można je również uruchomić z poziomu interfejsu użytkownika NetWorker i monitorować tam postęp. W Data Domain, /ddr/var/log/debug/messages.engineering po zakończeniu montowania wydanego przez NetWorker zostaną wyświetlone wpisy dziennika, takie jak ten poniżej: 
Apr 1 15:20:49 dd.example.com ddfs[17040]: NOTICE: ddboost-<client.example.com-49808>: Boostfs:
Apr 1 15:22:52.395 16275 704915520 [I] DDBoost Plugin Version is: [7.0.0.0.633508]
Apr 1 15:20:49 dd.example.com ddfs[17040]: NOTICE: ddboost-<client.example.com-49808>: Boostfs:
Apr 1 15:22:52.395 16275 704915520 [I] BoostFS Version info: [BOOSTFS:7.0.0.0-633922 FUSE:2.9.7]
Apr 1 15:20:49 dd.example.com ddfs[17040]: NOTICE: ddboost-<client.example.com-49808>: Boostfs:
Apr 1 15:22:52.395 16275 704915520 [I] bfs_lib_init: Mounting dd.example.com:LSU_NAME on /mnt/mountpoint

Produkty, których dotyczy problem

Data Domain

Produkty

Data Domain
Właściwości artykułu
Numer artykułu: 000064347
Typ artykułu: How To
Ostatnia modyfikacja: 11 maj 2026
Wersja:  4
Znajdź odpowiedzi na swoje pytania u innych użytkowników produktów Dell
Usługi pomocy technicznej
Sprawdź, czy Twoje urządzenie jest objęte usługą pomocy technicznej.