Data Domain: Anleitung zum Troubleshooting von Installations-, Konfigurations- und Mount-Problemen bei Boostfs

Zusammenfassung: Dieser Artikel hilft dem Nutzer, einige typische BOOSTFS-Installations- und Konfigurationsprobleme zu identifizieren und zu beheben.

Dieser Artikel gilt für Dieser Artikel gilt nicht für Dieser Artikel ist nicht an ein bestimmtes Produkt gebunden. In diesem Artikel werden nicht alle Produktversionen aufgeführt.
Andere Ressourcen ansehen

Weisungen

BoostFS ist eine Softwarekomponente, die in einigen Betriebssystemen installiert werden kann. Sie ermöglicht es dem Nutzer, DD Boost-Backups auf einer Data Domain auszuführen, ohne eine bestimmte Backupanwendung zu verwenden, und gleichzeitig einige der Funktionen zu nutzen, die mit der Verwendung einer Boost-fähigen Backupanwendung wie NetBackup, NetWorker oder Avamar einhergehen.
 
 
Dieser Wissensdatenbank-Artikel enthält jedoch einige der typischen Probleme, die bei der Konfiguration und Verwendung von BoostFS auftreten können. Es dient als schnelle Referenz für diese typischen Fehler, Fehlermeldungen und wie man sie löst. Typische Fehler dieser Art wären "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error" oder "Backup or restore fails with error", um nur einige zu nennen.
 

Häufige Probleme mit BoostFS

  1. Erforderliche Abhängigkeit bei der Installation der BoostFS-Software fehlt
Wenn die bereitgestellte BoostFS-Software-RPM im Linux-Clientbetriebssystem nicht installiert werden kann, ermitteln Sie zunächst, welche Paketabhängigkeiten für die BoostFS-Software erforderlich sind:
# 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
 
Im obigen Beispiel fragt das Paket nach dem FUSE ("Filesystem in USEr space") zu installierende Binärdateien und Bibliotheken (BoostFS basiert auf Linux's FUSE) sowie jedes Paket, das eine Shell (sh) und die Standard-RPM-Bibliotheken. Daher sollte dieses BoostFS-Paket normal auf dem Linux-System "rpm" ausgeführt wurde.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
Der obige Fehler kann auftreten, wenn Sie versuchen, die Data Domain-Remotespeichereinheit über BoostFS lokal im Linux-Client zu mounten. Überprüfen Sie die BoostFS-Protokolldatei auf dem Linux-Client. Im ersten Beispiel unten enthält die Lockbox-Datei beispielsweise keinen Eintrag für den Host data.domain.comverwalten: 
# 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
 
Die Lösung besteht in diesem Fall darin, einen Lockbox-Eintrag für den Data Domain-Zielhost und die Speichereinheit hinzuzufügen, die lokal gemountet werden sollen. Die Syntax ähnelt dem folgenden Beispiel:
# /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
 
Ein weiterer möglicher Fehler, der in den lokalen BoostFS-Clientprotokollen angezeigt werden kann, ist, dass der Data Domain-Hostname nicht vom Client aufgelöst wird. Zum Beispiel:
# 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
 
Die Lösung besteht in diesem Fall darin, entweder einen statischen Hostnamen zur IP-Zuordnung zur Linux-Client- /etc/host -Datei oder um die Zuordnung im verwendeten DNS-Server zu konfigurieren.
 
  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.
 
Die obige Meldung bedeutet, dass der angegebene Einhängepunkt (/mnt/mountpoint) kann nicht verwendet werden, um die Data Domain-Remotespeichereinheit anzuzeigen, da auf dem Einhängepunkt zuvor kein anderes Dateisystem gemountet sein darf oder Inhalte enthalten darf. /mnt/mountpoint/ muss ein leeres und nicht verwendetes Verzeichnis im Linux-Client sein. Wenn der Pfad bereits über einen Mount-Punkt verfügt, geben Sie einen anderen Mount-Punkt an. Zum Beispiel: 
# 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)
 
In diesem Fall ist die Data Domain-Remotespeichereinheit bereits unter /mnt/mountpoint/ und kann daher nicht erneut im selben Verzeichnis gemountet werden.
 
  1. BoostFS-Mount reagiert nicht mehr (es kann sogar mehr als 10 Minuten dauern, bis er wiederhergestellt ist)
Dies kann auftreten, wenn eine Firewall zwischen dem Linux-Client und dem Data Domain-Zielgerät Datenverkehr zu den TCP-Ports 111 und 2049 trennt. Überprüfen Sie, ob der Linux-Client die Data Domain über die TCP-Ports 111 und 2049 erreichen kann, und versuchen Sie es erneut. Zum Beispiel:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Dies ist ein Beispiel dafür, was in einem solchen Fall in den BoostFS-Protokollen des Linux-Clients angezeigt wird:
# 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" beim Versuch, auf Inhalte unter dem Einhängepunkt zuzugreifen oder diese aufzulisten
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Das Problem könnte darin bestehen, dass keine TCP-Verbindung zu den Data Domain-Remoteports 111 und 2049 besteht oder dass die Lockbox-Authentifizierung abgelaufen ist. Überprüfen Sie, ob der Linux-Client Data Domain auf den angegebenen Ports weiterhin erreichen kann, und versuchen Sie erneut, die Lockbox für die Remote-Data Domain, die Speichereinheit und den DD Boost-Nutzer einzurichten.
 
  1. “Insufficient access to or storage-unit does not exist" bei Verwendung der Kerberos-Authentifizierung
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
Bei Verwendung der Kerberos-Authentifizierung für die Lockbox ist der wahrscheinlichste Grund für den Fehler, dass das Kerberos-Authentifizierungsticket abgelaufen ist. Überprüfen Sie das erwähnte Ticket unter Linux wie folgt:
# /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
 
Überprüfen Sie auf der Data Domain, ob der der Speichereinheit zugewiesene DD Boost-Nutzer mit dem Nutzer auf dem Linux-Client übereinstimmt, wenn Sie die Lockbox einrichten und BoostFS mounten. Der AD-Nutzername und der Nutzername der Storage-Einheit müssen identisch sein:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Vergewissern Sie sich außerdem, dass die Datums- und Uhrzeitangaben auf der Data Domain, dem Linux-Client und dem Kerberos-Server (AD) nicht mehr als 5 Minuten voneinander abweichen. Probleme mit Tickets, die aufgrund inkonsistenter Zeit abgelaufen sind, können auftreten, wenn sie zu weit auseinander liegen.
 
Im Folgenden finden Sie ein Beispiel dafür, was in den Data Domain-Protokollen angezeigt wird, wenn die Zeit mehr als 5 Minuten voneinander abweicht:
# 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
 
Und diese sind für die BoostFS-Linux-Hostprotokolle:
# 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. Das BoostFS-Mounten mit Kerberos-Authentifizierung schlägt mit dem Fehler "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
 
Wenn Sie BoostFS-Konfigurationsoptionen in "/opt/emc/boostfs/etc/boostfs.conf", überprüfen Sie "[global]" in der Datei und vergewissern Sie sich, dass sie nicht auskommentiert ist. Das Schlüsselwort "[global]" wird standardmäßig kommentiert und muss auskommentiert werden, damit eine der globalen Optionen funktioniert.
 
Beispielinhalte von BoostFS "/opt/emc/boostfs/etc/boostfs.confKonfigurationsdatei: 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Beispielausgabe aus den BoostFS-Protokollen des Linux-Clients:
# 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
 
Der Fehler kann auch darauf zurückzuführen sein, dass im Linux-Client ein anderer Hostname, Storage-Einheitsname oder DD Boost-Nutzername verwendet wird "mount" im Vergleich zu dem, der für die Einrichtung der Lockbox verwendet wird, oder denen, die der Ziel-Data Domain entsprechen. Stellen Sie sicher, dass alle Namen in der Data Domain, der BoostFS-Lockbox und der "mount"-Befehl.
 
  1. Versucht, "boostfs" Nutzeranmeldedaten schlagen mit dem folgenden Fehler fehl:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Kerberos-Zugangsdaten können nicht festgelegt werden.
  1. Überprüfen Sie, ob die Active Directory-Nutzerzugangsdaten korrekt sind, indem Sie sich mit Active Directory-Nutzeranmeldedaten beim DC anmelden.
  2. Stellen Sie sicher, dass die Zeiten auf dem Linux-Client und dem Kerberos-Server nicht mehr als 5 Minuten voneinander abweichen. Die Kerberos-Authentifizierung erfordert, dass die Uhrzeiten nicht mehr als 5 Minuten voneinander abweichen.
 
  1. Das Mounten von BoostFS im Linux-Client schlägt mit dem Fehler "fusermount: mount failed: Operation not permitted.“
Dafür kann es mehrere Gründe geben. “fusermount" ist der zugrunde liegende Linux-Befehl, der letztendlich FUSE , um die DD Boost-Speichereinheit lokal im Linux-Client-Namespace zu mounten. Dazu sind spezielle Berechtigungen erforderlich. Aus diesem Grund "fusermount" ist eine SUID-Binärdatei im Linux-Client: 
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
Eine SUID-Binärdatei zu sein, bedeutet, dass unabhängig vom Nutzer, der den Versuch ausführt, die Speichereinheit zu mounten, die "fusermount" läuft mit "root"-Privilegien. Wenn "fusermount" ist nicht SUID zu root, nur den Linux-Client root Der Nutzer kann die Remote-BOOST-Storage-Einheit mounten. Dies ist möglicherweise kein Problem, wenn Sie die Halterung unter /etc/fstab, sondern wenn ein Nicht-root Der Nutzer muss das Mounten durchführen.
 
  1. BoostFS mountet OK, aber Versuche, auf den Inhalt der Storage-Einheit am Mount-Punkt zuzugreifen, schlagen mit Berechtigungsfehlern fehl
Beim manuellen Mounten der Speichereinheit mithilfe von Data Domain "boostfs"-Befehl oder /etc/fstab (oder sogar "mount.fuse" aus der CLI), ist es der zugrunde liegende Wert des Standardwerts FUSE Implementierung, um nur den Zugriff auf Dateien für den Linux-Client zu ermöglichen userid , die das BoostFS gemountet hat. Wenn der Mount also als root erstellt wurde, kann nur root auf die Dateien zugreifen. Wenn das Mounten als Nutzer "postgres" (zum Sichern einer PostgreSQL-Datenbank) hätte, hätte nur dieser Nutzer die Berechtigung, auf die Dateien zuzugreifen.
 
Wenn andere Nutzer in der Lage sein müssen, über die Linux-Cloud auf die Dateien in der gemounteten Speichereinheit zuzugreifen, wird das /etc/fuse.conf Möglicherweise muss optimiert werden. Weitere Informationen finden Sie hier: Ubuntu Manpage: SicherungDieser Hyperlink führt Sie zu einer Website außerhalb von Dell Technologies.
 
Legen Sie die folgende Option in /etc/fuse.confverwalten: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Verwenden Sie dann beim Mounten der BOOST-Speichereinheit über die Befehlszeile die folgende:
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 unterstützt keine unidirektionale oder bidirektionale Authentifizierung mithilfe von Zertifikaten. Verwenden Sie 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. Wenn beim Mounten der Speichereinheit SSL-Fehler auftreten, stellen Sie sicher, dass das Netzwerk die MTU zwischen dem Client und der Data Domain nicht reduziert.
  2. Stellen Sie sicher, dass Data Domain nicht so konfiguriert ist, dass eine unidirektionale oder bidirektionale Authentifizierung mithilfe von Zertifikaten erforderlich ist. 
    # 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. Fragen Sie den Kunden, ob er die Konfiguration ändern kann zu two-way-password oder 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. Wenn die Clients auch unidirektional oder bidirektional sein müssen, muss dies ebenfalls geändert werden, damit BoostFS auf Data Domain gemountet werden kann. Bitten Sie um Erlaubnis, welche der folgenden Änderungen ausgewählt werden soll. Wenn die aktuellen Einstellungen auf der Data Domain beide "none", dann müssen keine Änderungen vorgenommen werden. Fahren Sie mit dem Testen eines BoostFS-Mount fort. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Option 1: Ändern der vorhandenen Konfiguration, um two-way-password und die vorhandene Verschlüsselungsstärke. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Option 2: Fügen Sie einen neuen Client für diesen aktuellen BoostFS-Mounting-Client hinzu. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Weitere Informationen

Fragen zur Konfiguration von BoostFS:

  1. Wie viele Einhängepunktabschnitte können maximal in der BoostFS-Konfigurationsdatei definiert werden?
Es gibt keine Begrenzung für die Anzahl der Mounts im Abschnitt "Mount-Punkt" der boostfs.conf zu verwenden. 
# 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. Unterstützt NetWorker BoostFS?
NetWorker unterstützt BoostFS standardmäßig und kann On-the-fly-Mounts zur Durchführung bestimmter Aufgaben und Backups verarbeiten.
 
Obwohl es sich bei NetWorker um eine DD Boost-fähige Backupanwendung handelt, wird BoostFS auch auf Linux-Clientsystemen unterstützt, auf denen es installiert ist. Ein Beispiel für ein NetWorker-Backup, das über die Befehlszeile des Linux-Clients erstellt wird, sobald die BoostFS-Lockbox eingerichtet wurde, wäre das Folgende (PostgreSQL-Backup):
# 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.
 
Sobald der Backupjob konfiguriert ist, kann er auch über die NetWorker-Benutzeroberfläche gestartet und der Fortschritt dort überwacht werden. Auf der Data Domain /ddr/var/log/debug/messages.engineering würde Protokolleinträge wie den folgenden anzeigen, wenn das von NetWorker ausgegebene Mounten abgeschlossen ist: 
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

Betroffene Produkte

Data Domain

Produkte

Data Domain
Artikeleigenschaften
Artikelnummer: 000064347
Artikeltyp: How To
Zuletzt geändert: 11 Mai 2026
Version:  4
Antworten auf Ihre Fragen erhalten Sie von anderen Dell NutzerInnen
Support Services
Prüfen Sie, ob Ihr Gerät durch Support Services abgedeckt ist.