Data Domain : Comment résoudre les problèmes d’installation, de configuration et de montage de Boostfs

Résumé: Cet article aide l’utilisateur à identifier et à résoudre certains problèmes classiques d’installation et de configuration de BOOSTFS.

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.
Consulter d’autres ressources

Instructions

BoostFS est un composant logiciel qui peut être installé dans certains systèmes d’exploitation. Il permet à l’utilisateur d’exécuter des sauvegardes DD Boost sur un système Data Domain sans utiliser d’application de sauvegarde particulière, tout en tirant parti de certaines des fonctionnalités associées à une application de sauvegarde compatible Boost, comme NetBackup, NetWorker ou Avamar.
 
Pour plus d’informations précises sur l’installation et l’utilisation, consultez Data Domain : Accélération des étapes et des détails de configuration du système de fichiers Data Domain Boost.
 
Toutefois, cet article de la base de connaissances contient certains des problèmes typiques qui peuvent être rencontrés lors de la configuration et de l’utilisation de BoostFS. Il sert de référence rapide pour les erreurs et messages d’erreur typiques et la façon de les résoudre. Des erreurs typiques de ce type seraient «Unable to install Boostfs onto Linux server," "Boostfs mount fails with error» ou «Backup or restore fails with error», pour n’en nommer que quelques-uns.
 

Problèmes courants liés à BoostFS

  1. Il manque la dépendance requise lors de l’installation du logiciel BoostFS
En cas d’échec de l’installation du RPM logiciel BoostFS fourni dans le système d’exploitation client Linux, commencez par déterminer les dépendances de package requises pour le logiciel 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
 
Dans l’exemple ci-dessus, le paquet demande l’attribut FUSE (système de fichiers dans l’espace USEr) binaires et bibliothèques à installer (BoostFS est basé sur la méthode de FUSE), ainsi que tout paquet fournissant un shell (sh) et les bibliothèques RPM par défaut. Par conséquent, ce package BoostFS doit normalement installer sur le système Linux le messagerpm" a été exécuté.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
L’erreur ci-dessus peut se produire lors de la tentative de montage local de l’unité de stockage Data Domain distante dans le client Linux via BoostFS. Vérifiez le fichier log BoostFS sur le client Linux. Par exemple, dans le premier exemple ci-dessous, le fichier de lockbox ne contient pas d’entrée pour l’hôte 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
 
Dans ce cas, la solution consiste à ajouter une entrée de lockbox pour l’hôte Data Domain de destination et l’unité de stockage à monter localement. La syntaxe serait similaire à l’exemple ci-dessous :
# /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
 
Une autre erreur possible qui peut être observée dans les logs du client BoostFS locaux est le nom d’hôte Data Domain qui ne se résout pas à partir du client. Par exemple :
# 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
 
Dans ce cas, la solution consiste à ajouter un nom d’hôte statique au mappage IP du client Linux /etc/host ou pour configurer le mappage dans le serveur DNS utilisé.
 
  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.
 
Le message ci-dessus indique que le point de montage spécifié (/mnt/mountpoint) ne peut pas être utilisé pour afficher l’unité de stockage Data Domain distante, car aucun autre système de fichiers ne peut être monté précédemment sur le point de montage, ni avoir de contenu. /mnt/mountpoint/ doit être un répertoire vide et inutilisé dans le client Linux. Si le chemin dispose déjà d’un montage, spécifiez un autre point de montage. Par exemple : 
# 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)
 
Dans ce cas, l’unité de stockage Data Domain distante est déjà montée sous /mnt/mountpoint/ et ne peut donc pas être monté à nouveau dans le même répertoire.
 
  1. Le montage BoostFS cesse de répondre (le retour peut prendre plus de 10 minutes)
Cela peut se produire lorsqu’un pare-feu entre le client Linux et le périphérique Data Domain cible supprime le trafic vers les ports TCP 111 et 2049. Vérifiez que le client Linux peut atteindre Data Domain sur les ports TCP 111 et 2049, puis réessayez. Par exemple :
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Voici un exemple de ce qui s’affiche dans les journaux BoostFS du client Linux dans un tel cas :
# 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" lorsque vous tentez d’accéder au contenu sous le point de montage ou de le répertorier
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Le problème peut venir du fait qu’il n’existe aucune connectivité TCP aux ports Data Domain 111 et 2049 distants ou que l’authentification du lockbox a expiré. Vérifiez que le client Linux peut toujours accéder au système Data Domain sur les ports spécifiés et essayez de configurer à nouveau le lockbox pour le système Data Domain distant, l’unité de stockage et l’utilisateur DD Boost.
 
  1. »Insufficient access to or storage-unit does not exist" lors de l’utilisation de l’authentification Kerberos
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
Lors de l’utilisation de l’authentification Kerberos pour le lockbox, la raison la plus probable de l’erreur est que le ticket d’authentification Kerberos a expiré. Vérifiez le ticket mentionné à partir de Linux comme ci-dessous :
# /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
 
Sur le système Data Domain, vérifiez que l’utilisateur DD Boost attribué à l’unité de stockage correspond à l’utilisateur du client Linux lors de la configuration du lockbox et du montage de BoostFS. Le nom d’utilisateur AD et le nom d’utilisateur de l’unité de stockage doivent être identiques :
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Vérifiez également que les dates et heures sur le système Data Domain, le client Linux et le serveur Kerberos (AD) ne sont pas séparées de plus de 5 minutes. Des problèmes avec des tickets expirés en raison d’heures incohérentes peuvent se produire s’ils sont trop éloignés les uns des autres.
 
Vous trouverez ci-dessous un exemple de ce qui apparaîtrait dans les journaux Data Domain si l’heure était différente de plus de 5 minutes :
# 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
 
Pour les logs de l’hôte 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. Le montage BoostFS avec l’authentification Kerberos échoue avec l’erreur «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
 
Si vous avez l’intention d’utiliser les options de configuration de BoostFS dans «/opt/emc/boostfs/etc/boostfs.conf« , vérifiez le paramètre »[global]" dans le fichier, et vérifiez qu’il n’est pas mis en commentaire. Le mot-clé "[global]" est commentée par défaut et doit être non commentée pour que l’une des options globales fonctionne.
 
Exemple de contenu du fichier BoostFS «/opt/emc/boostfs/etc/boostfs.conf" Fichier de configuration : 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Exemple de sortie des logs BoostFS du 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’erreur peut également être le résultat de l’utilisation d’un nom d’hôte, d’un nom d’unité de stockage ou d’un nom d’utilisateur DD Boost différent dans le client Linuxmount", par rapport à celle utilisée pour configurer le lockbox, ou celles qui correspondent au Data Domain cible. Assurez-vous que tous les noms correspondent dans le système Data Domain, le lockbox BoostFS et le «mount" commande.
 
  1. Tente de définir «boostfs« Les informations d’identification de l’utilisateur échouent avec l’erreur suivante :
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Impossible de définir les informations d’identification Kerberos.
  1. Vérifiez que les informations d’identification de l’utilisateur Active Directory sont correctes en vous connectant au contrôleur de domaine avec les informations d’identification de l’utilisateur Active Directory.
  2. Vérifiez que les heures sur le client Linux et le serveur Kerberos ne sont pas séparées de plus de 5 minutes. L’authentification Kerberos exige que les heures d’horloge ne soient pas espacées de plus de 5 minutes.
 
  1. Le montage de BoostFS dans le client Linux échoue avec l’erreur «fusermount: mount failed: Operation not permitted.»
Cela peut être dû à plusieurs raisons. »fusermount" est la commande Linux sous-jacente qui, en fin de compte, utilise FUSE pour monter l’unité de stockage DD Boost localement dans l’espace de nommage du client Linux. Pour ce faire, vous devez disposer de privilèges spéciaux. C’est pourquoi «fusermount" est un binaire SUID dans le client Linux : 
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
Être un binaire SUID signifie que, quel que soit l’utilisateur qui exécute la tentative de montage de l’unité de stockage, le message «fusermount« s’exécute avec »root" privilèges. Si "fusermount" n’est pas SUID à root, uniquement le client Linux root L’utilisateur peut monter l’unité de stockage BOOST distante. Cela ne pose pas forcément de problème si vous installez le montage sous /etc/fstab, mais ce serait le cas lorsqu’unroot C’est l’utilisateur qui doit effectuer le montage.
 
  1. BoostFS se monte correctement, mais les tentatives d’accès au contenu de l’unité de stockage au point de montage échouent avec des erreurs d’autorisation
Lors du montage manuel de l’unité de stockage à l’aide de l’un des outils Data Domain "boostfs" ou /etc/fstab (ou même "mount.fuse" de l’interface de ligne de commande), c’est le sous-jacent de la valeur par défaut FUSE implémentation pour n’autoriser l’accès aux fichiers qu’au client Linux userid qui a monté le BoostFS. Ainsi, si le montage a été effectué en tant qu’utilisateur root, seul root peut accéder aux fichiers. Si le montage a été effectué en tant qu’utilisateur «postgres" (pour la sauvegarde d’une base de données PostgreSQL), seul cet utilisateur aurait l’autorisation d’accéder aux fichiers.
 
Si d’autres utilisateurs doivent être en mesure d’accéder aux fichiers de l’unité de stockage montée à partir du Cloud Linux, le /etc/fuse.conf peut nécessiter un réglage. Pour en savoir plus, cliquez ici : Ubuntu Manpage : fuseCe lien hypertexte renvoie à un site Web extérieur à Dell Technologies.
 
Définissez l’option suivante dans /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Ensuite, utilisez la suivante lors du montage de l’unité de stockage BOOST, à partir de la ligne de commande :
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 ne prend pas en charge l’authentification unidirectionnelle ou bidirectionnelle à l’aide de certificats. Utilisez two-way-password à la place.
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. Si des erreurs liées au protocole SSL se produisent lors du montage de l’unité de stockage, vérifiez que le réseau ne réduit pas la MTU entre le client et le système Data Domain.
  2. Assurez-vous que le Data Domain n’est pas configuré pour exiger une authentification unidirectionnelle ou bidirectionnelle à l’aide de certificats. 
    # 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. Demandez au client s’il peut modifier la configuration pour two-way-password ou 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. Si les clients doivent également être unidirectionnels ou bidirectionnels, cette option doit également être modifiée pour permettre le montage de BoostFS sur le système Data Domain. Demander l’autorisation de choisir parmi les modifications suivantes. Si les paramètres actuels du Data Domain sont à la fois "none», alors aucune modification n’a besoin d’être apportée. Procédez au test d’un montage BoostFS. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Option 1 : Modifier leur configuration existante pour utiliser two-way-password et la puissance de chiffrement existante. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Option 2 : Ajoutez un nouveau client pour ce client de montage BoostFS actuel. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Informations supplémentaires

Questions relatives à la configuration de BoostFS :

  1. Quel est le nombre maximal de sections de point de montage pouvant être définies dans le fichier de configuration BoostFS ?
Il n’existe aucune limite au nombre de montages dans la section des points de montage du boostfs.conf . 
# 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 prend-il en charge BoostFS ?
NetWorker prend en charge BoostFS par défaut et peut gérer les montages à la volée pour effectuer certaines tâches et sauvegardes.
 
NetWorker est une application de sauvegarde compatible DD Boost, mais elle prend également en charge BoostFS sur les systèmes clients Linux sur lesquels elle est installée. Voici un exemple de sauvegarde NetWorker effectuée à partir de la ligne de commande du client Linux, une fois le lockbox BoostFS configuré, comme suit (sauvegarde 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.
 
Une fois la procédure de sauvegarde configurée, elle peut également être lancée à partir de l’interface utilisateur NetWorker et sa progression peut y être surveillée. Sur le système Data Domain, /ddr/var/log/debug/messages.engineering affiche des entrées de journal comme celle ci-dessous lorsque le montage émis par NetWorker est effectué : 
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

Produits concernés

Data Domain

Produits

Data Domain
Propriétés de l’article
Numéro d’article: 000064347
Type d’article: How To
Dernière modification: 11 May 2026
Version:  4
Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
Services de support
Vérifiez si votre appareil est couvert par les services de support.