Data Domain: Come risolvere i problemi di installazione, configurazione e mount di BoostFS

Riepilogo: Questo articolo aiuta l'utente a identificare e risolvere alcuni problemi tipici di installazione e configurazione di BOOSTFS.

Questo articolo si applica a Questo articolo non si applica a Questo articolo non è legato a un prodotto specifico. Non tutte le versioni del prodotto sono identificate in questo articolo.
Scopri le altre risorse

Istruzioni

BoostFS è un componente software che potrebbe essere installato in alcuni sistemi operativi. Consente all'utente di eseguire i backup di DD Boost su un Data Domain senza utilizzare alcuna applicazione di backup specifica, sfruttando al contempo alcune delle funzionalità fornite con l'utilizzo di un'applicazione di backup abilitata per Boost, come NetBackup, NetWorker o Avamar.
 
Per ulteriori dettagli sull'installazione e l'utilizzo, consultare Data Domain: Procedura di configurazione rapida e dettagli per il file system Data Domain Boost.
 
Questo articolo della KB, tuttavia, contiene alcuni dei problemi tipici che possono verificarsi durante la configurazione e l'utilizzo di BoostFS. Funge da riferimento rapido per gli errori tipici, i messaggi di errore e il modo in cui risolverli. Tali errori tipici sarebbero "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error", oppure "Backup or restore fails with error", solo per citarne alcuni.
 

Problemi comuni di BoostFS

  1. Dipendenza richiesta mancante durante l'installazione del software BoostFS
Se non è possibile installare l RPM del software BoostFS fornito nel sistema operativo Linux client, determinare innanzitutto quali sono le dipendenze del pacchetto richieste per il software 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
 
Nell'esempio precedente, il pacchetto richiede l'attributo FUSE ("Filesystem nello spazio USEr") binari e librerie da installare (BoostFS è basato su Linux FUSE), così come qualsiasi pacchetto che fornisca una shell (sh) e le librerie RPM predefinite. Pertanto, questo pacchetto BoostFS dovrebbe essere installato normalmente nel sistema Linux "rpm" è stato eseguito.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
L'errore di cui sopra può verificarsi quando si tenta di montare l'unità di storage Data Domain remota in locale nel client Linux tramite BoostFS. Esaminare il file di registro BoostFS sul client Linux. Ad esempio, nel primo esempio riportato di seguito, il file lockbox non contiene una voce per l'host 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
 
La soluzione in questo caso consiste nell'aggiungere una voce lockbox per l'host Data Domain di destinazione e l'unità di storage di cui eseguire il mount localmente. La sintassi sarebbe simile all'esempio seguente:
# /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
 
Un altro possibile errore che può essere visualizzato nei registri del client BoostFS locale è che il nome host di Data Domain non viene risolto dal client. Ad esempio:
# 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
 
La soluzione in questo caso consiste nell'aggiungere un nome host statico al mapping IP del client Linux /etc/host o per configurare il mapping nel server DNS in uso.
 
  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.
 
Il messaggio precedente indica che il mount point specificato (/mnt/mountpoint) non può essere utilizzato per mostrare l'unità di storage Data Domain remota, in quanto il mount point non può avere un altro file system montato in precedenza su di esso o avere alcun contenuto. /mnt/mountpoint/ deve essere una directory vuota e inutilizzata nel client Linux. Se il percorso dispone già di un mount, specificare un altro mount point. Ad esempio: 
# 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 questo caso, l'unità di storage Data Domain remota è già montata in /mnt/mountpoint/ e quindi non può essere montato di nuovo nella stessa directory.
 
  1. Il mount di BoostFS smette di rispondere (potrebbero essere necessari anche più di 10 minuti per il ripristino)
Ciò potrebbe verificarsi quando un firewall tra il client Linux e il dispositivo Data Domain di destinazione indirizza il traffico alle porte TCP 111 e 2049. Verificare che il client Linux sia in grado di raggiungere Data Domain sulle porte TCP 111 e 2049, quindi riprovare. Ad esempio:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Questo è un esempio di ciò che verrebbe visualizzato nei registri BoostFS del client Linux in un caso del genere:
# 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" quando si tenta di accedere o elencare i contenuti sotto il mount point
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Il problema potrebbe essere l'assenza di connettività TCP alle porte remote 111 e 2049 di Data Domain o la scadenza dell'autenticazione del lockbox. Verificare che il client Linux sia ancora in grado di raggiungere Data Domain sulle porte specificate e provare a configurare nuovamente il lockbox per l'utente Data Domain, l'unità di storage e DD Boost remoto.
 
  1. ".Insufficient access to or storage-unit does not exist" quando si utilizza l'autenticazione Kerberos
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
Quando si utilizza l'autenticazione Kerberos per il lockbox, il motivo più probabile dell'errore è che il ticket di autenticazione Kerberos è scaduto. Controllare il ticket menzionato da Linux come indicato di seguito:
# /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
 
In Data Domain, verificare che l'utente DD Boost assegnato all'unità di storage corrisponda all'utente sul client Linux durante la configurazione del lockbox e il mounting di BoostFS. Il nome utente AD e il nome utente dell'unità di storage devono essere identici:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Verificare inoltre che le date e le ore su Data Domain, sul client Linux e sul server Kerberos (AD) non distano più di 5 minuti l'una dall'altra. Se sono troppo distanti, possono verificarsi problemi con i ticket scaduti a causa di un orario incoerente.
 
Di seguito è riportato un esempio di ciò che verrebbe visualizzato nei log di Data Domain se il differenza di tempo fosse di oltre 5 minuti:
# 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
 
Questi sono per i log dell'host BoostFS Linux:
# 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. Il mount di BoostFS con autenticazione Kerberos ha esito negativo con l'errore "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
 
Se si intende utilizzare le opzioni di configurazione di BoostFS in "/opt/emc/boostfs/etc/boostfs.conf," verificare il "[global]" nel file e verificare che non sia commentato. La parola chiave "[global]" è commentato per impostazione predefinita e deve essere decommentato affinché una qualsiasi delle opzioni globali funzioni.
 
Contenuto di esempio di BoostFS "/opt/emc/boostfs/etc/boostfs.conf" file di configurazione: 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Output di esempio dai registri BoostFS del client 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
 
L'errore può anche essere il risultato dell'utilizzo di un nome host, un nome dell'unità di storage o un nome utente DD Boost diverso nel client Linux "mount", rispetto a quello utilizzato per la configurazione dell'archivio protetto o a quelli che corrispondono al Data Domain di destinazione. Assicurarsi che tutti i nomi corrispondano in Data Domain, nel lockbox BoostFS e nel "mount" comando.
 
  1. Tenta di impostare "boostfs" Le credenziali utente hanno esito negativo con il seguente errore:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Impossibile impostare le credenziali Kerberos.
  1. Verificare che le credenziali utente di Active Directory siano corrette accedendo al controller di dominio con le credenziali utente di Active Directory.
  2. Verificare che i tempi sul client Linux e sul server Kerberos non siano più di 5 minuti l'uno dall'altro. L'autenticazione Kerberos richiede che le ore di clock non distorcano più di 5 minuti l'una dall'altra.
 
  1. Il mounting di BoostFS nel client Linux ha esito negativo con l'errore "fusermount: mount failed: Operation not permitted.".
Ciò può essere dovuto a diversi motivi. ".fusermount" è il comando Linux sottostante che utilizza FUSE per montare l'unità di storage DD Boost localmente nel namespace del client Linux. A tale scopo, sono necessari privilegi speciali. Ecco perché "fusermount" è un binario SUID nel client Linux: 
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
Essendo un binario SUID significa che, indipendentemente dall'utente che esegue il tentativo di montare l'unità di storage, il "fusermount" viene eseguito con "root" privilegi. Se "fusermount" non è SUID per root, solo il client Linux root l'utente può montare l'unità di storage BOOST remota. Questo potrebbe non essere un problema se si configura il montaggio in /etc/fstab, ma sarebbe quando unroot L'utente deve eseguire il mount.
 
  1. Il mount di BoostFS è corretto, ma i tentativi di accesso al contenuto dell'unità di storage sul mount point hanno esito negativo con errori di autorizzazione
Quando si monta manualmente l'unità di storage, utilizzando "boostfs" comando o /etc/fstab (o anche "mount.fuse" dalla CLI), è il sottostante dell'impostazione predefinita FUSE implementazione per consentire solo l'accesso ai file sul client Linux userid che ha montato il BoostFS. Quindi, se il mount è stato effettuato come root, solo root può accedere ai file. Se il mount è stato effettuato come utente "postgres" (per eseguire il backup di un database PostgreSQL), solo questo utente avrà l'autorizzazione per accedere ai file.
 
Se altri utenti devono essere in grado di accedere ai file nell'unità di storage montata dal cloud Linux, il /etc/fuse.conf potrebbe richiedere una messa a punto. Per ulteriori informazioni, cliccare qui: Ubuntu Manpage: fusibileQuesto link ipertestuale indirizza a un sito web esterno a Dell Technologies.
 
Impostare la seguente opzione in /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Utilizzare il seguente metodo dalla riga di comando durante il mounting dell'unità di storage BOOST:
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 non supporta l'autenticazione unidirezionale o bidirezionale tramite certificati. Utilizzare 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. Se si verificano errori con SSL durante il mounting dell'unità di storage, verificare che la rete non stia riducendo la MTU tra il client e Data Domain.
  2. Assicurarsi che Data Domain non sia configurato per richiedere l'autenticazione unidirezionale o bidirezionale tramite certificati. 
    # 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. Chiedere al cliente se può modificare la configurazione in two-way-password oppure 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. Se anche i client devono essere unidirezionali o bidirezionali, anche questa operazione deve essere modificata per consentire il mount di BoostFS su Data Domain. Richiedere l'autorizzazione per quale delle seguenti modifiche scegliere. Se le impostazioni correnti su Data Domain sono "none", non è necessario apportare modifiche. Procedere con il test di un mount BoostFS. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Opzione 1. Modificare la configurazione esistente per utilizzare two-way-password e la potenza di crittografia esistente. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Opzione 2. Aggiungere un nuovo client per questo client di mounting BoostFS corrente. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Informazioni aggiuntive

Domande correlate alla configurazione di BoostFS:

  1. Qual è il numero massimo di sezioni del mount point che è possibile definire nel file di configurazione di BoostFS?
Non vi è alcun limite al numero di montaggi nella sezione del mount point di boostfs.conf di 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. NetWorker supporta BoostFS?
NetWorker supporta BoostFS per impostazione predefinita ed è in grado di gestire i mount al volo per l'esecuzione di determinate attività e backup.
 
Anche se NetWorker è un'applicazione di backup abilitata per DD Boost, supporta anche BoostFS sui sistemi client Linux in cui è installato. Un esempio di backup di NetWorker ricavato dalla riga di comando del client Linux, una volta configurato il lockbox BoostFS, è il seguente (backup 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.
 
Una volta configurato il processo di backup, è anche possibile avviarlo dall'interfaccia utente di NetWorker e monitorarne l'avanzamento. In Data Domain, /ddr/var/log/debug/messages.engineering mostrerebbe voci di registro come quella riportata di seguito al termine del mount emesso da NetWorker: 
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

Prodotti interessati

Data Domain

Prodotti

Data Domain
Proprietà dell'articolo
Numero articolo: 000064347
Tipo di articolo: How To
Ultima modifica: 11 mag 2026
Versione:  4
Trova risposta alle tue domande dagli altri utenti Dell
Support Services
Verifica che il dispositivo sia coperto dai Servizi di supporto.