Data Domain: Så här felsöker du problem med installation, konfiguration och montering av Boostfs

Sammanfattning: Den här artikeln hjälper användaren att identifiera och lösa några typiska BOOSTFS-installations- och konfigurationsproblem.

Den här artikeln gäller för Den här artikeln gäller inte för Den här artikeln är inte kopplad till någon specifik produkt. Alla produktversioner identifieras inte i den här artikeln.
Kolla in andra resurser

Instruktioner

BoostFS är en mjukvarukomponent som kan vara installerad i vissa operativsystem. Det gör det möjligt för användaren att köra DD Boost-säkerhetskopieringar till en Data Domain utan att använda något särskilt säkerhetskopieringsprogram, samtidigt som det utnyttjar några av funktionerna som kommer med att använda ett Boost-aktiverat säkerhetskopieringsprogram som NetBackup, NetWorker eller Avamar.
 
 
Den här kunskapsbasartikeln innehåller dock några av de vanliga problem som kan uppstå när du konfigurerar och använder BoostFS. Den fungerar som en snabbreferens för de typiska felen, felmeddelandena och hur man löser dem. Typiska sådana fel skulle vara "Unable to install Boostfs onto Linux server," "Boostfs mount fails with error" eller "Backup or restore fails with error", för att nämna några.
 

Vanliga problem med BoostFS

  1. Obligatoriskt beroende saknas vid installation av BoostFS-mjukvaran
Om det inte går att installera det angivna BoostFS-programvaru-RPM:et i klientoperativsystemet Linux ska du först fastställa vilka paketberoenden som krävs för BoostFS-programvaran:
# 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 exemplet ovan ber paketet om FUSE ("Filesystem in USEr space") binärer och bibliotek som ska installeras (BoostFS är baserat på Linux's FUSE), samt alla förpackningar som tillhandahåller ett skal (sh) och standardbiblioteken för RPM. Därför bör detta BoostFS-paket installeras normalt i Linux-systemet "rpm" har körts på.
 
  1. Cannot mount /mnt/mountpoint/: unexpected error
Ovanstående fel kan inträffa när du försöker montera den fjärranslutna Data Domain-lagringsenheten lokalt i Linux-klienten via BoostFS. Granska BoostFS-loggfilen på Linux-klienten. I det första exemplet nedan innehåller till exempel lockbox-filen inte någon post för värden 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 det här fallet är att lägga till en lockbox-post för mål-Data Domain-värden och -lagringsenheten som ska monteras lokalt. Syntaxen skulle likna exemplet nedan:
# /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
 
Ett annat möjligt fel som kan ses i de lokala BoostFS-klientloggarna är att Data Domain-värdnamnet inte matchas från klienten. Till exempel:
# 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 det här fallet är att antingen lägga till ett statiskt värdnamn till IP-mappning till Linux-klientens /etc/host eller för att konfigurera mappningen på den DNS-server som används.
 
  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.
 
Meddelandet ovan innebär att den angivna monteringspunkten (/mnt/mountpoint) kan inte användas för att visa den fjärranslutna Data Domain-lagringsenheten, eftersom monteringspunkten inte kan ha ett annat filsystem monterat på den tidigare eller ha något innehåll. /mnt/mountpoint/ måste vara en tom och oanvänd katalog i Linux-klienten. Om sökvägen redan har en monteringspunkt anger du en annan monteringspunkt. Till exempel: 
# 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 det här fallet är Data Domain-fjärrlagringsenheten redan monterad under /mnt/mountpoint/ och kan därför inte monteras igen i samma katalog.
 
  1. BoostFS-fästet slutar svara (kan ta mer än 10 minuter att returnera)
Detta kan inträffa när en brandvägg mellan Linux-klienten och Data Domain-målenheten släpper trafik till TCP-portarna 111 och 2049. Kontrollera att Linux-klienten kan nå Data Domain på TCP-portarna 111 och 2049 och försök sedan igen. Till exempel:
# /opt/emc/boostfs//bin/boostfs mount -d data.domain.com -s LSU2 /mnt/mountpoint/
 
Det här är ett exempel på vad som skulle visas i Linux-klientens BoostFS-loggar i ett sådant fall:
# 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 försöker komma åt eller lista innehåll under monteringspunkten
# ls -l /mnt/mountpoint/
ls: reading directory .: Operation not permitted
total 0
 
Problemet kan vara att det inte finns någon TCP-anslutning till fjärrData Domain-portarna 111 och 2049, eller att lockbox-autentiseringen har upphört att gälla. Kontrollera att Linux-klienten fortfarande kan nå Data Domain på de angivna portarna och försök konfigurera lockbox för fjärrData Domain, lagringsenheten och DD Boost-användaren igen.
 
  1. ”Insufficient access to or storage-unit does not exist" när du använder Kerberos-autentisering
# boostfs mount -s LSU3 -d data.domain.com /mnt/mountpoint/
Insufficient access to or storage-unit LSU3 does not exist
 
När du använder Kerberos-autentisering för den säkra databasen är den troligaste orsaken till felet att Kerberos-autentiseringsbiljetten har upphört att gälla. Kontrollera den nämnda biljetten från Linux enligt nedan:
# /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 kontrollerar du att DD Boost-användaren som tilldelats lagringsenheten matchar användaren på Linux-klienten när du konfigurerar lockbox och monterar BoostFS. AD-användarnamnet och lagringsenhetens användarnamn måste vara identiska:
# ddboost storage-unit show
Name   Pre-Comp (GiB)   Status   User       Report Physical   Tenant-Unit
                                               Size (MiB)
----   --------------   ------   --------   ---------------   -----------
LSU3              0.0   RW       username                 -   -
----   --------------   ------   --------   ---------------   -----------
 
Kontrollera också att datum och tider på Data Domain, Linux-klienten och Kerberos-servern (AD) inte är mer än 5 minuter från varandra. Problem med biljetter som löpt ut på grund av inkonsekvent tid kan uppstå om de är för långt ifrån varandra.
 
Nedan visas ett exempel på vad som skulle visas i Data Domain-loggarna om tiden var mer än 5 minuter annorlunda:
# 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
 
Och det här är för BoostFS Linux-värdloggarna:
# 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-autentisering misslyckas med felet "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
 
Om du tänker använda konfigurationsalternativen för BoostFS i "/opt/emc/boostfs/etc/boostfs.conf", verifiera "[global]" i filen och bekräfta att den inte har kommenterats bort. Nyckelordet "[global]" kommenteras som standard och måste vara okommenterad för att något av de globala alternativen ska fungera.
 
Exempel på innehåll i 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
 
Exempel på utdata från Linux-klientens BoostFS-loggar:
# 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
 
Felet kan också bero på att du använder ett annat värdnamn, lagringsenhetsnamn eller DD Boost-användarnamn i Linux-klienten "mount" jämfört med den som används för att konfigurera lockbox eller de som motsvarar målData Domain. Se till att alla namn matchar i Data Domain, BoostFS-lockboxen och "mount"-kommandot.
 
  1. Försöker ställa in "boostfs" Användaruppgifterna misslyckas med följande fel:
bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Failed getting initial credentials.]
 
Det går inte att ange Kerberos-autentiseringsuppgifter.
  1. Kontrollera att Active Directory-användarautentiseringsuppgifterna är korrekta genom att logga in på domänkontrollanten med Active Directory-användarautentiseringsuppgifter.
  2. Kontrollera att tiderna på Linux-klienten och Kerberos-servern inte är mer än 5 minuter från varandra. Kerberos-autentisering kräver att klocktiderna inte är mer än 5 minuter från varandra.
 
  1. Det går inte att montera BoostFS i Linux-klienten med felet "fusermount: mount failed: Operation not permitted.”
Detta kan bero på någon av flera anledningar. ”fusermount" är det underliggande Linux-kommandot som i slutändan använder FUSE för att montera DD Boost-lagringsenheten lokalt i Linux-klientnamnområdet. För att göra det krävs särskilda privilegier. Det är därför "fusermount" är 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
 
Att vara en SUID-binär fil innebär att oavsett vilken användare som kör försöket att montera lagringsenheten, "fusermount" körs med "root" Privilegier. Om "fusermount" är inte SUID för att root, endast Linux-klienten root användaren kan montera den fjärrstyrda BOOST-lagringsenheten. Detta kanske inte är ett problem om du ställer in fästet under /etc/fstab, men skulle vara när en icke-root Användaren måste utföra monteringen.
 
  1. BoostFS monteras OK, men försök att komma åt lagringsenhetens innehåll vid monteringspunkten misslyckas med behörighetsfel
När du monterar lagringsenheten manuellt med hjälp av antingen Data Domain "boostfs" kommando eller /etc/fstab (eller till och med "mount.fuse" från CLI) är det standardenhetens underliggande FUSE implementering för att endast tillåta åtkomst till filer till Linux-klienten userid som monterade BoostFS. Så om monteringen gjordes som root, kan endast root komma åt filerna. Om fästet gjordes som användare "postgres" (för säkerhetskopiering av en PostgreSQL-databas) är det bara den här användaren som har behörighet att komma åt filerna.
 
Om andra användare måste kunna komma åt filerna i den monterade lagringsenheten från Linux-molnet kommer /etc/fuse.conf kan kräva inställning. Se mer information här: Ubuntu Manpage: säkringDen här hyperlänken tar dig till en webbplats utanför Dell Technologies.
 
Ställ in följande alternativ i /etc/fuse.conf: 
user_allow_other
       Allow non-root users to specify the allow_other or allow_root mount options (see below).
Använd sedan följande när du monterar BOOST-lagringsenheten från kommandoraden:
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öder inte envägs- eller tvåvägsautentisering med certifikat. Använd two-way-password Istället.
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. Om SSL-fel uppstår vid montering av lagringsenheten kontrollerar du att nätverket inte minskar MTU:n mellan klienten och Data Domain.
  2. Se till att Data Domain inte är konfigurerad för att kräva envägs- eller tvåvägsautentisering med hjälp av certifikat. 
    # 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. Fråga kunden om de kan ändra konfigurationen till 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. Om klienterna också måste vara enkelriktade eller tvåvägs, måste detta också ändras så att BoostFS kan monteras till Data Domain. Begär tillstånd för vilken av följande ändringar som skulle vara deras val. Om de aktuella inställningarna i Data Domain är både "none", behöver inga ändringar göras. Fortsätt med att testa ett BoostFS-fäste. 
    # ddboost client show config
Client   Encryption Strength   Authentication Mode
------   -------------------   -------------------
*        none**                none
------   -------------------   -------------------
    1. Alternativ 1: Ändra sin befintliga konfiguration så att den kan användas two-way-password och befintlig krypteringsstyrka. 
      ddboost clients modify * authentication-mode two-way-password encryption-strength { medium | high}
    2. Alternativ 2: Lägg till en ny klient för den aktuella BoostFS-monteringsklienten. 
      ddboost clients modify <client hostname> authentication-mode two-way-password encryption-strength medium

Ytterligare information

BoostFS-konfigurationsrelaterade frågor:

  1. Vilket är det maximala antalet monteringspunktssektioner som kan definieras i BoostFS-konfigurationsfilen?
Det finns ingen gräns för antalet fästen i monteringspunktsavsnittet i 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. Har NetWorker stöd för BoostFS?
NetWorker har stöd för BoostFS som standard och kan hantera monteringar i farten för att utföra vissa uppgifter och säkerhetskopieringar.
 
Även om NetWorker är ett DD Boost-aktiverat säkerhetskopieringsprogram har det även stöd för BoostFS på Linux-klientsystem där det är installerat. Ett exempel på en NetWorker-säkerhetskopiering som tas från Linux-klientens kommandorad, när BoostFS-lockboxen har konfigurerats, är följande (PostgreSQL-säkerhetskopiering):
# 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 säkerhetskopieringsjobbet har konfigurerats kan det också startas från NetWorker-gränssnittet och förloppet övervakas där. På Data Domain, /ddr/var/log/debug/messages.engineering skulle visa loggposter som den nedan när monteringen som utfärdats av NetWorker är klar: 
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örda produkter

Data Domain

Produkter

Data Domain
Artikelegenskaper
Artikelnummer: 000064347
Artikeltyp: How To
Senast ändrad: 11 maj 2026
Version:  4
Få svar på dina frågor från andra Dell-användare
Supporttjänster
Kontrollera om din enhet omfattas av supporttjänster.