Data Domain: Hvordan feilsøke Boostfs Problemer med installasjon, konfigurasjon og montering

Sammendrag: Denne artikkelen hjelper brukeren med å identifisere og løse noen typiske problemer med BOOSTFS-installasjon og -konfigurasjon.

Denne artikkelen gjelder for Denne artikkelen gjelder ikke for Denne artikkelen er ikke knyttet til noe bestemt produkt. Det er ikke produktversjonene som identifiseres i denne artikkelen.
Ta en titt på andre ressurser

Instruksjoner

BoostFS er en programvarekomponent som kan installeres i enkelte operativsystemer. Det gjør det mulig for brukeren å kjøre DD Boost-sikkerhetskopieringer til et Data Domain uten å bruke et bestemt program for sikkerhetskopiering, samtidig som det utnytter noen av funksjonene som følger med bruk av et Boost-aktivert program for sikkerhetskopiering, for eksempel NetBackup, NetWorker eller Avamar.
 
Hvis du vil ha flere detaljer om installasjon og bruk rett på sak, kan du sjekke Data Domain: Fremskyndet konfigurasjonstrinn og detaljer for Data Domain Boost-filsystemet.
 
Denne kunnskapsartikkelen inneholder imidlertid noen av de typiske problemene som kan oppstå når du konfigurerer og bruker BoostFS. Det fungerer som en rask referanse for de typiske feilene, feilmeldingene og hvordan du løser dem. Typiske slike feil vil være "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error," eller "Backup or restore fails with errorFor å nevne noe.
 

Vanlige BoostFS-problemer

  1. Nødvendig avhengighet mangler når du installerer BoostFS-programvaren
Hvis det oppstår en feil ved å installere den medfølgende BoostFS-programvare-RPM i Linux-klientoperativsystemet, må du først finne ut hvilke som er de nødvendige pakkeavhengighetene for BoostFS-programvaren:
# 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 ber pakken om FUSE ("Filesystem in USEr space") binærfiler og biblioteker som skal installeres (BoostFS er basert på Linux's FUSE), samt enhver pakke som gir et skall (sh) og standard RPM-biblioteker. Derfor bør denne BoostFS-pakken installeres normalt i Linux-systemet "rpm" har blitt kjørt på.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
Feilen ovenfor kan oppstå når du prøver å montere den eksterne Data Domain-lagringsenheten lokalt i Linux-klienten gjennom BoostFS. Se gjennom BoostFS-loggfilen på Linux-klienten. I det første eksemplet nedenfor inneholder for eksempel ikke låseboksfilen en oppføring for verten 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 tilfellet er å legge til en låseboksoppføring for Data Domain-destinasjonsverten og lagringsenheten som skal monteres lokalt. Syntaksen ligner på 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 annen mulig feil som kan sees i de lokale BoostFS-klientloggene, er at Data Domain-vertsnavnet ikke løses fra klienten. Eksempel:
# 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 tilfellet er å enten legge til et statisk vertsnavn til IP-kartlegging til Linux-klientens /etc/host -filen, eller for å konfigurere tilordningen i DNS-serveren som brukes.
 
  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.
 
Meldingen ovenfor betyr at monteringspunktet angitt (/mnt/mountpoint) kan ikke brukes til å vise den eksterne Data Domain-lagringsenheten, ettersom monteringspunktet ikke kan ha et annet filsystem montert på det tidligere, eller har noe innhold. /mnt/mountpoint/ må være en tom og ubrukt katalog i Linux-klienten. Hvis banen allerede har en montering, angir du et annet monteringspunkt. Eksempel: 
# 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 tilfellet er den eksterne Data Domain-lagringsenheten allerede montert under /mnt/mountpoint/ og kan derfor ikke monteres på nytt i samme katalog.
 
  1. BoostFS-monteringen slutter å svare (det kan ta enda mer enn 10 minutter å returnere)
Dette kan skje når en brannmur mellom Linux-klienten og målenheten for Data Domain sender trafikk til TCP-port 111 og 2049. Kontroller at Linux-klienten kan nå Data Domain på TCP-port 111 og 2049, og prøv deretter på nytt. Eksempel:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Dette er et eksempel på hva som vil vises i Linux-klienten BoostFS-loggene i et slikt tilfelle:
# 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 prøver å få tilgang til eller føre opp innhold under monteringspunktet
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Problemet kan være at det ikke er noen TCP-tilkobling til de eksterne Data Domain-portene 111 og 2049, eller at låseboksgodkjenningen er utløpt. Kontroller at Linux-klienten fremdeles kan nå Data Domain på de angitte portene, og prøv å konfigurere låseboksen for det eksterne Data Domain, lagringsenheten og DD Boost-brukeren på nytt.
 
  1. »Insufficient access to or storage-unit does not exist" når du bruker Kerberos-godkjenning
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
Når du bruker Kerberos-godkjenning for låseboksen, er den mest sannsynlige årsaken til feilen at Kerberos-godkjenningsbilletten er utløpt. Sjekk den nevnte billetten 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 kontrollerer du at DD Boost-brukeren som er tilordnet lagringsenheten, samsvarer med brukeren på Linux-klienten ved oppsett av låseboks og montering av BoostFS. AD-brukernavnet og brukernavnet for lagringsenheten må være identisk:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Bekreft også at datoene og klokkeslettene på Data Domain, Linux-klienten og Kerberos-serveren (AD) ikke er mer enn 5 minutter fra hverandre. Problemer med billetter som er utløpt på grunn av inkonsekvent tid kan oppstå hvis de er for langt fra hverandre.
 
Nedenfor er et eksempel på hva som ville vises i Data Domain-loggene hvis tiden var mer enn 5 minutter forskjellig:
# 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 for BoostFS Linux-vertsloggene:
# 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-godkjenning mislykkes med feilen "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 har tenkt å bruke BoostFS-konfigurasjonsalternativer i "/opt/emc/boostfs/etc/boostfs.conf," bekreft "[global]" -innstillingen i filen, og bekreft at den ikke er kommentert ut. Nøkkelordet "[global]" kommenteres som standard, og må være ukommentert for at noen av de globale alternativene skal fungere.
 
Eksempel på innholdet i BoostFS "/opt/emc/boostfs/etc/boostfs.conf" konfigurasjonsfil: 
# Comments are not allowed after the option value pair.
#
#############################################################################
[global]
# Data Domain Hostname or IP address
# data-domain-system=data.domain.com
 
Eksempel på utdata fra Linux-klientens BoostFS-logger:
# 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
 
Feilen kan også være et resultat av å bruke et annet vertsnavn, lagringsenhetsnavn eller DD Boost-brukernavn i Linux-klienten "mount" -kommandoen, sammenlignet med den som brukes til å sette opp låseboksen, eller de som tilsvarer måldatadomenet. Kontroller at alle navnene samsvarer på tvers av Data Domain, BoostFS-låseboksen og "mount" kommando.
 
  1. Forsøk på å sette "boostfs" Brukerlegitimasjon mislykkes med følgende feil:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Kan ikke angi Kerberos-legitimasjon.
  1. Kontroller at Active Directory-brukerlegitimasjonen er riktig, ved å logge på DC med Active Directory-brukerlegitimasjon.
  2. Kontroller at det ikke er mer enn 5 minutter fra hverandre når det gjelder tider på Linux-klienten og Kerberos-serveren. Kerberos-godkjenning krever at klokketidene ikke er mer enn 5 minutter fra hverandre.
 
  1. Montering av BoostFS i Linux-klienten mislykkes med feilen "fusermount: mount failed: Operation not permitted.»
Dette kan skyldes en av flere årsaker. »fusermount" er den underliggende Linux-kommandoen som til slutt bruker FUSE for å montere DD Boost-lagringsenheten lokalt i Linux-klientnavneområdet. Dette krever spesielle privilegier. Det er 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
 
Å være en SUID binær betyr at uavhengig av brukeren som kjører forsøket på å montere lagringsenheten, er "fusermount" kjører med "root" privilegier. Hvis "fusermount" er ikke SUID til root, bare Linux-klienten root Brukeren kan montere den eksterne BOOST-lagringsenheten. Dette kan ikke være et problem hvis du setter opp monteringen under /etc/fstab, men ville være når en ikke-root Brukeren må utføre monteringen.
 
  1. BoostFS-monteringer er OK, men forsøk på å få tilgang til innholdet i lagringsenheten på monteringspunktet mislykkes på grunn av tillatelsesfeil
Når du monterer lagringsenheten manuelt ved hjelp av enten Data Domain "boostfs" kommando eller /etc/fstab (eller til og med "mount.fuse" fra CLI), er det standardens underliggende FUSE implementering for å bare tillate tilgang til filer til Linux-klienten userid som monterte BoostFS. Så hvis monteringen ble laget som root, kan bare roten få tilgang til filene. Hvis monteringen ble laget som bruker "postgres" (for sikkerhetskopiering av en PostgreSQL-database), ville bare denne brukeren ha tillatelse til å få tilgang til filene.
 
Hvis andre brukere må ha tilgang til filene i den monterte lagringsenheten fra Linux-skyen, vises /etc/fuse.conf kan kreve innstilling. Se flere detaljer her: Ubuntu Manpage: sikringDenne hyperkoblingen tar deg til et nettsted utenfor Dell Technologies.
 
Angi følgende alternativ i /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Og bruk deretter følgende når du monterer BOOST-lagringsenheten, 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 støtter ikke enveis eller toveis autentisering ved hjelp av sertifikater. Bruk two-way-password 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 det oppstår feil med SSL ved montering av lagringsenheten, må du kontrollere at nettverket ikke reduserer MTU-en mellom klienten og datadomenet.
  2. Kontroller at Data Domain ikke er konfigurert til å kreve enveis- eller toveisgodkjenning ved hjelp av sertifikater. 
    # 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ør kunden om de kan endre konfigurasjonen 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 klientene også må være enveis eller toveis, må dette også endres slik at BoostFS kan monteres på Data Domain. Be om tillatelse til hvilken av følgende endringer som vil være deres valg. Hvis de gjeldende innstillingene på datadomenet er begge "noneDa trenger det ikke gjøres endringer. Fortsett å teste et BoostFS-feste. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Alternativ 1: Endre eksisterende konfigurasjon som skal brukes two-way-password og eksisterende krypteringsstyrke. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Alternativ 2: Legg til en ny klient for denne gjeldende BoostFS-monteringsklienten. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Tilleggsinformasjon

BoostFS-konfigurasjonsrelaterte spørsmål:

  1. Hva er maksimalt antall monteringspunktseksjoner som kan defineres i BoostFS-konfigurasjonsfilen?
Det er ingen grense for antall monteringer i monteringspunktdelen av boostfs.conf Filen. 
# 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. Støtter NetWorker BoostFS?
NetWorker støtter BoostFS som standard, og kan håndtere monteringer underveis for å utføre bestemte oppgaver og sikkerhetskopieringer.
 
Selv om NetWorker er et DD Boost-aktivert sikkerhetskopieringsprogram, støtter det også BoostFS på Linux-klientsystemer der det er installert. Et eksempel på en NetWorker-sikkerhetskopi hentet fra Linux-klientens kommandolinje, når BoostFS-låseboksen er konfigurert, er følgende (PostgreSQL-sikkerhetskopi):
# 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 sikkerhetskopieringsjobben er konfigurert, kan den også sparkes fra NetWorker-brukergrensesnittet og overvåkes der. På datadomenet, /ddr/var/log/debug/messages.engineering vil vise loggoppføringer som den nedenfor når monteringen utstedt av NetWorker er ferdig: 
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
Artikkelegenskaper
Artikkelnummer: 000064347
Artikkeltype: How To
Sist endret: 11 mai 2026
Versjon:  4
Få svar på spørsmålene dine fra andre Dell-brukere
Støttetjenester
Sjekk om enheten din er dekket av støttetjenestene.