Data Domain: Sådan foretager du fejlfinding af problemer med installation, konfiguration og montering af Boostfs

Oversigt: Denne artikel hjælper brugeren med at identificere og løse nogle typiske BOOSTFS-installations- og konfigurationsproblemer.

Denne artikel gælder for Denne artikel gælder ikke for Denne artikel er ikke knyttet til et bestemt produkt. Det er ikke alle produktversioner, der er identificeret i denne artikel.
Udforsk andre ressourcer

Instruktioner

BoostFS er en softwarekomponent, der kan installeres i nogle operativsystemer. Det giver brugeren mulighed for at køre DD Boost-sikkerhedskopier til et Data Domain uden at bruge et bestemt sikkerhedskopieringsprogram, samtidig med at det udnytter nogle af de funktioner, der følger med at bruge et Boost-aktiveret sikkerhedskopieringsprogram såsom NetBackup, NetWork eller Avamar.
 
Du kan finde flere oplysninger om installation og anvendelse "lige til sagen" ved at se Data Domain: Fremskyndede konfigurationstrin og detaljer for Data Domain Boost-filsystemet.
 
Denne KB indeholder dog nogle af de typiske problemer, der kan findes, når du konfigurerer og bruger BoostFS. Det fungerer som en hurtig reference til de typiske fejl, fejlmeddelelser, og hvordan man løser dem. Typiske sådanne fejl ville være "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error" eller "Backup or restore fails with error" for at nævne nogle få.
 

Almindelige problemer med BoostFS

  1. Påkrævet afhængighed mangler ved installation af BoostFS-softwaren
Hvis der ikke installeres det medfølgende BoostFS-software-RPM i klientens Linux-operativsystem, skal du først afgøre, hvilke pakkeafhængigheder der kræves til BoostFS-softwaren:
# 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
 
I eksemplet ovenfor beder pakken om FUSE ("Filsystem i USEr-rum") binære filer og biblioteker, der skal installeres (BoostFS er baseret på Linux' FUSE), samt enhver pakke, der indeholder en skal (sh) og standardbibliotekerne for RPM. Derfor skal denne BoostFS-pakke installeres normalt i Linux-systemet "rpm" er blevet kørt på.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
Ovenstående fejl kan opstå, når du forsøger at tilslutte den eksterne Data Domain-lagerenhed lokalt i Linux-klienten via BoostFS. Gennemse BoostFS-logfilen på Linux-klienten. I det første eksempel herunder indeholder lockbox-filen f.eks. ikke en post for værten 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
 
Løsningen i dette tilfælde er at tilføje en nøglebokspost for destinationens Data Domain-vært og storageenhed, der skal monteres lokalt. Syntaks ligner eksemplet nedenfor:
# /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
 
En anden mulig fejl, der kan ses i de lokale BoostFS-klientlogfiler, er, at Data Domain-værtsnavnet ikke løses fra klienten. F.eks.:
# 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
 
Løsningen i dette tilfælde er enten at tilføje et statisk værtsnavn til IP-kortlægning til Linux-klientens /etc/host eller for at konfigurere tilknytningen på den DNS-server, der bruges.
 
  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.
 
Ovenstående meddelelse betyder, at monteringspunktet er angivet (/mnt/mountpoint) kan ikke bruges til at vise den eksterne Data Domain-lagerenhed, da monteringspunktet ikke tidligere kan have et andet filsystem monteret på det eller have noget indhold. /mnt/mountpoint/ skal være en tom og ubrugt mappe i Linux-klienten. Hvis kurven allerede har en holder, skal du angive et andet tilslutningspunkt. F.eks.: 
# 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)
 
I dette tilfælde er den eksterne Data Domain-storageenhed allerede monteret under /mnt/mountpoint/ og kan derfor ikke monteres igen i samme mappe.
 
  1. BoostFS-monteringen holder op med at reagere (det kan tage mere end 10 minutter at returnere den)
Dette kan opstå, når en firewall mellem Linux-klienten og destinationsenheden for Data Domain slipper trafik til TCP-port 111 og 2049. Kontroller, at Linux-klienten kan nå Data Domain på TCP-port 111 og 2049, og prøv derefter igen. F.eks.:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Dette er et eksempel på, hvad der ville vises i Linux-klientens BoostFS-logfiler i et sådant tilfælde:
# 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" når du forsøger at få adgang til eller liste indhold under monteringspunktet
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Problemet kan være, at der ikke er nogen TCP-forbindelse til de eksterne Data Domain-porte 111 og 2049, eller at lockbox-godkendelsen er udløbet. Kontroller, at Linux-klienten stadig kan nå Data Domain på de angivne porte, og prøv at konfigurere lockboxen for fjernbrugeren Data Domain, lagerenheden og DD Boost igen.
 
  1. "Insufficient access to or storage-unit does not exist" ved brug af Kerberos-godkendelse
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
Når du bruger Kerberos-godkendelse til nøgleboksen, er den mest sandsynlige årsag til fejlen, at Kerberos-godkendelsesbilletten er udløbet. Tjek den nævnte billet fra Linux som nedenfor:
# /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
 
På Data Domain skal du kontrollere, at den DD Boost-bruger, der er tildelt storageenheden, matcher brugeren på Linux-klienten, når lockboxen konfigureres og BoostFS monteres. AD-brugernavnet og lagerenhedens brugernavn skal være identiske:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Bekræft også, at der ikke er mere end 5 minutter mellem datoer og klokkeslæt på Data Domain, Linux-klienten og Kerberos-serveren (AD). Problemer med billetter, der er udløbet på grund af inkonsekvent tid, kan opstå, hvis de er for langt fra hinanden.
 
Nedenfor er et eksempel på, hvad der ville blive vist i Data Domain-logfilerne, hvis tiden var mere end 5 minutter anderledes:
# 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
 
Og disse er til BoostFS Linux-værtslogfiler:
# 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-montering med Kerberos-godkendelse mislykkes med fejlen "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
 
Hvis du vil bruge BoostFS-konfigurationsindstillinger i "/opt/emc/boostfs/etc/boostfs.conf" verificere "[global]" i filen, og bekræft, at den ikke er kommenteret. Nøgleordet "[global]" er kommenteret som standard og skal ikke kommenteres, for at en af de globale indstillinger kan fungere.
 
Eksempel på indhold af BoostFS "/opt/emc/boostfs/etc/boostfs.conf" konfigurationsfil: 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Eksempel på output fra BoostFS-logfiler for Linux-klient:
# 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
 
Fejlen kan også være resultatet af at bruge et andet værtsnavn, lagerenhedsnavn eller DD Boost-brugernavn i Linux-klienten "mount" sammenlignet med den, der bruges til at konfigurere lockboxen, eller dem, der svarer til måldatadomænet. Sørg for, at alle navne stemmer overens på tværs af Data Domain, BoostFS-lockboxen og "mount" kommando.
 
  1. Forsøger at indstille "boostfs" Brugeroplysninger mislykkes med følgende fejl:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Kerberos-legitimationsoplysninger kan ikke indstilles.
  1. Kontroller, at Active Directory-brugeroplysningerne er korrekte ved at logge på DC med Active Directory-brugerlegitimationsoplysninger.
  2. Kontroller, at der ikke er mere end 5 minutter mellem klokkeslættene på Linux-klienten og Kerberos-serveren. Kerberos-godkendelse kræver, at der ikke er mere end 5 minutter mellem klokkeslættene.
 
  1. Montering af BoostFS i Linux-klienten mislykkes med fejlen "fusermount: mount failed: Operation not permitted."
Dette kan skyldes en af flere årsager. "fusermount" er den underliggende Linux-kommando, der i sidste ende bruger FUSE for at montere DD Boost-lagerenheden lokalt i Linux-klientnavneområdet. Det kræver særlige privilegier. Derfor "fusermount" er en SUID-binær i Linux-klienten: 
# ls -l /usr/bin/fusermount
-rwsr-xr-x. 1 root root 38680 May 11 2019 /usr/bin/fusermount
 
At være en SUID-binær betyder, at uanset hvilken bruger der kører forsøget på at montere lagerenheden, er "fusermount" kører med "root" privilegier. Hvis "fusermount" er ikke SUID til root, kun Linux-klienten root kan brugeren montere den eksterne BOOST-lagerenhed. Dette er muligvis ikke et problem, hvis monteringen under /etc/fstab, men ville være, når en ikke-root Brugeren skal udføre monteringen.
 
  1. BoostFS-monteringer OK, men forsøg på at få adgang til lagerenhedens indhold på tilslutningspunktet mislykkes med tilladelsesfejl
Ved manuel montering af storageenheden ved hjælp af enten Data Domain "boostfs" kommando eller /etc/fstab (eller endda "mount.fuse" fra CLI), er det standardens underliggende FUSE implementering til kun at give adgang til filer til Linux-klienten userid der monterede BoostFS. Så hvis monteringen blev lavet som root, kan kun root få adgang til filerne. Hvis monteringen blev lavet som bruger "postgres" (til sikkerhedskopiering af en PostgreSQL-database), er det kun denne bruger, der har tilladelse til at få adgang til filerne.
 
Hvis andre brugere skal kunne få adgang til filerne i den tilsluttede lagerenhed fra Linux-skyen, vises ikonet /etc/fuse.conf kan kræve tuning. Se flere detaljer her: Ubuntu Manpage: sikringDette hyperlink fører dig til et websted uden for Dell Technologies.
 
Angiv følgende indstilling i /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Og brug derefter den følgende, når du monterer BOOST-storageenheden, fra kommandolinjen:
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 understøtter ikke envejs- eller tovejsgodkendelse ved hjælp af certifikater. Brug two-way-password i stedet.
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. Hvis der opstår fejl med SSL ved montering af storageenheden, skal du kontrollere, at netværket ikke reducerer MTU'en mellem klienten og Data Domain.
  2. Sørg for, at Data Domain ikke er konfigureret til at kræve envejs- eller tovejsgodkendelse ved hjælp af certifikater. 
    # 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. Spørg kunden, om de kan ændre konfigurationen til two-way-password eller 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. Hvis klienterne også skal være envejs eller tovejs, skal dette også ændres, så BoostFS kan tilsluttes Data Domain. Anmod om tilladelse til, hvilken af følgende ændringer der ville være deres valg. Hvis de aktuelle indstillinger på Data Domain begge er "none", så behøver der ikke foretages ændringer. Fortsæt med at teste en BoostFS-montering. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Valgmulighed 1: Ændre deres eksisterende konfiguration for at bruge two-way-password og eksisterende krypteringsstyrke. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Valgmulighed 2: Tilføj en ny klient til denne aktuelle BoostFS-monteringsklient. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Flere oplysninger

BoostFS-konfigurationsrelaterede spørgsmål:

  1. Hvad er det maksimale antal monteringspunktsektioner, der kan defineres i BoostFS-konfigurationsfilen?
Der er ingen grænse for antallet af monteringer i monteringspunktsektionen på boostfs.conf Fil. 
# 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. Understøtter NetWorker BoostFS?
NetWorker understøtter BoostFS som standard og kan håndtere løbende monteringer til udførelse af visse opgaver og sikkerhedskopieringer.
 
Selvom NetWorker er et DD Boost-aktiveret sikkerhedskopieringsprogram, understøtter det også BoostFS på Linux-klientsystemer, hvor det er installeret. Et eksempel på NetWorker-sikkerhedskopiering taget fra Linux-klientens kommandolinje, når BoostFS-lockboxen er blevet konfigureret, ville være følgende (PostgreSQL-sikkerhedskopiering):
# 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.
 
Når sikkerhedskopieringsjobbet er konfigureret, kan det også startes fra NetWorker-brugergrænsefladen, og status overvåges der. På Data Domain, /ddr/var/log/debug/messages.engineering ville vise logposter som den nedenfor, når monteringen udstedt af NetWorker er færdig: 
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

Berørte produkter

Data Domain

Produkter

Data Domain
Artikelegenskaber
Artikelnummer: 000064347
Artikeltype: How To
Senest ændret: 11 maj 2026
Version:  4
Find svar på dine spørgsmål fra andre Dell-brugere
Supportservices
Kontrollér, om din enhed er dækket af supportservices.