Data Domain: Problemen met installatie, configuratie en koppeling van Boostfs oplossen

Samenvatting: Dit artikel helpt de gebruiker bij het identificeren en oplossen van enkele typische BOOSTFS-installatie- en configuratieproblemen.

Dit artikel is van toepassing op Dit artikel is niet van toepassing op Dit artikel is niet gebonden aan een specifiek product. Niet alle productversies worden in dit artikel vermeld.
Bekijk andere hulpbronnen

Instructies

BoostFS is een softwarecomponent die op sommige besturingssystemen kan zijn geïnstalleerd. Hiermee kan de gebruiker DD Boost-back-ups uitvoeren naar een Data Domain zonder een bepaalde back-upapplicatie te gebruiken, terwijl ook enkele van de functies worden gebruikt die worden geleverd met het gebruik van een Boost-back-upapplicatie, zoals NetBackup, NetWorker of Avamar.
 
Voor meer "to the point" installatie- en gebruiksdetails, raadpleegt u Data Domain: Versnelde configuratiestappen en details voor Data Domain Boost-bestandssysteem.
 
Dit KB-artikel bevat echter enkele van de typische problemen die kunnen optreden bij het configureren en gebruiken van BoostFS. Het dient als een snelle referentie voor die typische fouten, foutmeldingen en hoe ze op te lossen. Typische dergelijke fouten zijn "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error" of "Backup or restore fails with error", om er maar een paar te noemen.
 

Veelvoorkomende problemen met BoostFS

  1. Vereiste afhankelijkheid ontbreekt bij het installeren van de BoostFS-software
Als het installeren van de opgegeven BoostFS software RPM mislukt in het Linux-besturingssysteem van de client, moet u eerst bepalen wat de vereiste pakketafhankelijkheden zijn voor de BoostFS-software:
# 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
 
In het bovenstaande voorbeeld vraagt het pakket om de FUSE ("Filesystem in USEr space") binaire bestanden en bibliotheken die moeten worden geïnstalleerd (BoostFS is gebaseerd op Linux's FUSE), alsmede elke verpakking die een omhulsel bevat (sh) en de standaard RPM-bibliotheken. Daarom wordt dit BoostFS-pakket normaal geïnstalleerd in het Linux-systeem met de "rpm" is uitgevoerd.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
De bovenstaande fout kan optreden wanneer u probeert de externe Data Domain-storage-eenheid lokaal in de Linux-client te koppelen via BoostFS. Controleer het BoostFS-logbestand op de Linux-client. In het eerste voorbeeld hieronder bevat het lockbox-bestand bijvoorbeeld geen vermelding voor de 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
 
De oplossing in dit geval is om een lockbox-vermelding toe te voegen voor de bestemming Data Domain host en storage-eenheid die lokaal moeten worden gekoppeld. De syntaxis is vergelijkbaar met het onderstaande voorbeeld:
# /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
 
Een andere mogelijke fout die kan worden weergegeven in de lokale BoostFS-clientlogboeken is dat de Data Domain-hostnaam niet wordt omgezet vanuit de client. Bijvoorbeeld:
# 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
 
De oplossing is in dit geval om een statische hostnaam toe te voegen aan IP-toewijzing aan de /etc/host bestand te configureren of om de toewijzing in de gebruikte DNS-server te configureren.
 
  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.
 
Het bovenstaande bericht betekent dat het opgegeven koppelpunt (/mnt/mountpoint) kan niet worden gebruikt om de externe Data Domain-opslageenheid weer te geven, omdat op het koppelpunt niet eerder een ander bestandssysteem kan zijn gekoppeld of inhoud mag bevatten. /mnt/mountpoint/ moet een lege en ongebruikte map in de Linux-client zijn. Als het pad al een koppelpunt heeft, geeft u een ander koppelpunt op. Bijvoorbeeld: 
# 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 dit geval is de externe Data Domain-storage-eenheid al gekoppeld onder /mnt/mountpoint/ en kan daarom niet opnieuw in dezelfde directory worden gemount.
 
  1. BoostFS bevestiging reageert niet meer (het kan zelfs meer dan 10 minuten duren voordat deze terugkeert)
Dit kan gebeuren wanneer een firewall tussen de Linux-client en het doeldatadomeinapparaat verkeer naar TCP-poorten 111 en 2049 laat vallen. Controleer of de Linux-client het Data Domain op TCP-poorten 111 en 2049 kan bereiken en probeer het opnieuw. Bijvoorbeeld:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Dit is een voorbeeld van wat er in zo'n geval in de BoostFS-logboeken van de Linux-client zou verschijnen:
# 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" bij het openen of weergeven van inhoud onder het koppelpunt
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Het probleem kan zijn dat er geen TCP-connectiviteit is met de externe Data Domain-poorten 111 en 2049 of dat de lockbox-authenticatie is verlopen. Controleer of de Linux-client het Data Domain op de opgegeven poorten nog steeds kan bereiken en probeer de lockbox voor het externe Data Domain, de storage-eenheid en de DD Boost-gebruiker opnieuw in te stellen.
 
  1. "Insufficient access to or storage-unit does not exist" bij gebruik van Kerberos-authenticatie
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
Bij het gebruik van Kerberos-authenticatie voor de lockbox is de meest waarschijnlijke reden voor de fout dat het Kerberos-authenticatieticket is verlopen. Controleer het genoemde ticket van Linux zoals hieronder:
# /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
 
Controleer in het Data Domain of de DD Boost-gebruiker die aan de storage-eenheid is toegewezen, overeenkomt met de gebruiker op de Linux-client bij het instellen van de lockbox en het koppelen van BoostFS. De AD-gebruikersnaam en de gebruikersnaam van de storage-eenheid moeten identiek zijn:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Controleer ook of er niet meer dan 5 minuten tussen de datums en tijden op het Data Domain, de Linux-client en de Kerberos-server (AD) liggen. Problemen met verlopen tickets vanwege inconsistente tijd kunnen optreden als ze te ver uit elkaar liggen.
 
Hieronder ziet u een voorbeeld van wat er in de Data Domain-logboeken zou worden weergegeven als de tijd meer dan 5 minuten afwijkt:
# 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
 
Deze zijn voor de BoostFS Linux-hostlogboeken:
# 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. BoostFS-koppeling met Kerberos-verificatie mislukt met de fout "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
 
Als u van plan bent BoostFS configuratieopties te gebruiken in "/opt/emc/boostfs/etc/boostfs.conf," verifieer de "[global]" in het bestand en bevestig dat er geen commentaar op is gegeven. Het trefwoord "[global]" wordt standaard becommentarieerd en moet zonder commentaar worden teruggezet om een van de algemene opties te laten werken.
 
Voorbeeldinhoud van de BoostFS "/opt/emc/boostfs/etc/boostfs.conf" Configuratiebestand: 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Voorbeelduitvoer van de BoostFS-logboeken van de Linux-client:
# 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
 
De fout kan ook het gevolg zijn van het gebruik van een andere hostnaam, naam van de opslageenheid of DD Boost-gebruikersnaam in de Linux-client "mount" commando, vergeleken met degene die wordt gebruikt voor het instellen van de lockbox, of degene die overeenkomen met het doel-Data Domain. Zorg ervoor dat alle namen overeenkomen in het Data Domain, de BoostFS lockbox en de "mount" commando.
 
  1. Pogingen om "boostfs" user credentials fail with the volgende error:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Kan Kerberos-referenties niet instellen.
  1. Controleer of Active Directory-gebruikersreferenties correct zijn door u aan te melden bij de DC met Active Directory-gebruikersreferenties.
  2. Controleer of de tijden op de Linux-client en de Kerberos-server niet meer dan 5 minuten uit elkaar liggen. Kerberos-authenticatie vereist dat de kloktijden niet meer dan 5 minuten uit elkaar liggen.
 
  1. Het koppelen van de BoostFS in de Linux-client mislukt met de foutmelding "fusermount: mount failed: Operation not permitted."
Dit kan verschillende redenen hebben. "fusermount" is het onderliggende Linux-commando dat uiteindelijk gebruikmaakt van FUSE om de DD Boost-storage-eenheid lokaal in de naamruimte van de Linux-client te koppelen. Hiervoor zijn speciale bevoegdheden vereist. Dat is de reden waarom "fusermount" is een SUID-binair bestand in de Linux-client: 
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
Omdat het een SUID-binair bestand is, betekent dit dat, ongeacht de gebruiker die de poging uitvoert om de opslageenheid te koppelen, de "fusermount" loopt met "root" privileges. Als "fusermount" is niet SUID voor root, alleen de Linux-client root de gebruiker kan de externe BOOST-opslageenheid monteren. Dit hoeft geen probleem te zijn als u de houder eronder /etc/fstab, maar zou zijn wanneer een niet-root De gebruiker moet de koppeling uitvoeren.
 
  1. BoostFS wordt OK gekoppeld, maar pogingen om toegang te krijgen tot de inhoud van de storage-eenheid op het koppelpunt mislukken door toestemmingsfouten
Bij handmatige montage van de storage-eenheid met behulp van het Data Domain "boostfs" commando of /etc/fstab (of zelfs "mount.fuse" van de CLI), is dit de onderliggende FUSE implementatie om alleen toegang tot bestanden toe te staan aan de Linux-client userid die de BoostFS monteerde. Dus als de koppeling als root is gemaakt, heeft alleen root toegang tot de bestanden. Als de houder is gemaakt als gebruiker "postgres" (voor het maken van een back-up van een PostgreSQL-database) heeft alleen deze gebruiker toestemming om toegang te krijgen tot de bestanden.
 
Als andere gebruikers vanuit de Linux-cloud toegang moeten hebben tot de bestanden in de gekoppelde storage-eenheid, wordt het /etc/fuse.conf Mogelijk moet er worden afgestemd. Zie hier meer details: Ubuntu Manpage: zekeringDeze hyperlink leidt u naar een website buiten Dell Technologies.
 
Stel de volgende optie in /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
En gebruik vervolgens de volgende bij het monteren van de BOOST-opslageenheid, vanaf de opdrachtregel:
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 biedt geen ondersteuning voor eenrichtings- of tweerichtingsverificatie met behulp van certificaten. Gebruik two-way-password in plaats daarvan.
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. Als er fouten met SSL optreden bij het koppelen van de storage-eenheid, controleer dan of het netwerk de MTU tussen de client en het Data Domain niet vermindert.
  2. Zorg ervoor dat het Data Domain niet is geconfigureerd om eenrichtings- of tweerichtingsverificatie met behulp van certificaten te vereisen. 
    # 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. Vraag de klant of ze de configuratie kunnen wijzigen in two-way-password of 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. Als de clients ook eenrichtings- of tweerichtingsverkeer moeten zijn, moet dit ook worden gewijzigd om BoostFS toe te staan aan het Data Domain te koppelen. Vraag toestemming voor welke van de volgende wijzigingen hun keuze zou zijn. Als de huidige instellingen op het Data Domain zowel "none", dan hoeven er geen wijzigingen te worden aangebracht. Ga verder met het testen van een BoostFS-mount. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Optie 1: Hun bestaande configuratie wijzigen om te gebruiken two-way-password en de bestaande coderingssterkte. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Optie 2: Voeg een nieuwe client toe voor deze huidige BoostFS mounting client. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Extra informatie

Vragen over BoostFS configuratie:

  1. Wat is het maximale aantal koppelpuntsecties dat kan worden gedefinieerd in het BoostFS configuratiebestand?
Er is geen limiet voor het aantal bevestigingen in het koppelpuntgedeelte van de boostfs.conf Bestand. 
# 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. Ondersteunt NetWorker BoostFS?
NetWorker ondersteunt BoostFS standaard en kan on-the-fly mounts verwerken voor het uitvoeren van bepaalde taken en back-ups.
 
Hoewel NetWorker een back-upapplicatie is die geschikt is voor DD Boost, ondersteunt het ook BoostFS op Linux-clientsystemen waarop het is geïnstalleerd. Een voorbeeld van een NetWorker-back-up die wordt gemaakt vanaf de opdrachtregel van de Linux-client, nadat de BoostFS lockbox is ingesteld, is het volgende (PostgreSQL-back-up):
# 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.
 
Zodra de back-uptaak is geconfigureerd, kan deze ook worden gestart vanuit de NetWorker-gebruikersinterface en kan de voortgang daar worden gecontroleerd. Op het gebied van datadomein, /ddr/var/log/debug/messages.engineering zou logboekvermeldingen zoals de onderstaande weergeven wanneer de koppeling door NetWorker is voltooid: 
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

Getroffen producten

Data Domain

Producten

Data Domain
Artikeleigenschappen
Artikelnummer: 000064347
Artikeltype: How To
Laatst aangepast: 11 mei 2026
Versie:  4
Vind antwoorden op uw vragen via andere Dell gebruikers
Support Services
Controleer of uw apparaat wordt gedekt door Support Services.