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

BOOSTFS är en mjukvarukomponent som kan installeras i vissa operativsystem, som ger möjlighet att köra BOOST-säkerhetskopior till en DataDomain utan att använda något särskilt säkerhetskopieringsprogram, samtidigt som man utnyttjar några av de funktioner som följer med att använda ett BOOST-aktiverat säkerhetskopieringsprogram som Netbackup, Networker och Avamar.

Mer information om installation och användning finns i Data Domain: Snabba konfigurationssteg och information för DataDomain BOOST FS KB-artikel.

Den här kunskapsbasartikeln innehåller dock några av de typiska problem som kan uppstå när du konfigurerar och använder BOOSTFS, så att kunderna kan få en snabbreferens för de typiska felen och felmeddelandena och hur de ska lösas. Typiska sådana fel skulle vara "Det går inte att installera Boostfs på Linux-servern", "Boostfs-monteringen misslyckas med fel" eller "Säkerhetskopiering eller återställning misslyckas med fel", för att nämna några.

1. Obligatoriskt beroende saknas vid installation av BOOST FS-mjukvaran

Om det inte går att installera den angivna BOOSTFS-programvaru-RPM 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 >säkring = 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 att FUSE-binärerna (Filesystem in USEr space) ska installeras (BOOSTFS är baserat på Linux FUSE), såväl som alla paket som tillhandahåller ett skal (sh) och standard-RPM-biblioteken. Därför bör detta BOOSTFS-paket installeras normalt i det Linux-system som "rpm" har körts på.


2. veckor Det går inte att montera /mnt/mountpoint/: oväntat fel

När du försöker montera DD-fjärrlagringsenheten lokalt i Linux-klienten via BOOSTFS kan du få felet ovan. Granska BOOSTFS-loggfilen i Linux-klienten. I det första exemplet nedan innehåller till exempel lockbox-filen ingen post för värden dd2500-abc.datadomain.com:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 29 juli 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Det gick inte att hitta nyckelposten dd2500-abc.datadomain.com:LSU2 i konfigurationsfilen /opt/emc/boostfs/lockbox/boostfs.lockbox. Det gick inte att hitta den begärda Lockbox-posten. 29 juli 03:45:25 22795 3267069888 [E] bfs_conn_lookup: anslutningssökningen misslyckades för nod 0-filen /.boostfs_sysinfo. (0 anslutningar) Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: Det gick inte att få en anslutning för fil /.boostfs_sysinfo 29 juli 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: initieringen misslyckades

Lösningen i det här fallet är att lägga till en lockbox-post för DD-målvärden och -lagringsenheten som ska monteras lokalt. Syntaxen skulle likna exemplet nedan:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Ange användarlösenord för lagringsenhet: Ange lagringsenhetens användarlösenord igen för att bekräfta: Låsbar box entry set

Ett annat möjligt fel som kan ses i de lokala BOOSTFS-klientloggarna är att DD-värdnamnet inte matchar från klienten, till exempel:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 29 juli 04:05:50 22882 3322156992 [E] bfs_conn_open: anslutningen misslyckades (0 anslutningar): 5037 29 juli 04:05:50 22882 3322156992 [E] bfs_conn_lookup: anslutningssökning misslyckades för nod 0-fil /.boostfs_sysinfo. (0 anslutningar) 29 juli 04:05:50 22882 3322156992 [I] bfs_node_lookup: Det gick inte att få en anslutning för fil /.boostfs_sysinfo 29 juli 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: initieringen misslyckades

 
Lösningen i det här fallet är att antingen lägga till en statisk hosntame till IP-mappning till Linux-klientens /etc/host-fil eller konfigurera mappningen på den DNS-server som används.


3. veckor Monteringspunkten /mnt/monteringspunkten är inte tom.
BoostFS kan inte monteras på en icke-tom monteringspunkt. Försök att montera på en tom monteringspunkt.

Meddelandet ovan innebär att den angivna monteringspunkten (/mnt/mountpoint) inte kan användas för att visa DD-fjärrlagringsenheten, 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 måste du ange en annan monteringspunkt. Till exempel:

# montera /dev/mapper/VG00-lv_root PÅ/skriv EXT4 (RW) /dev/sda1 på /boot typ ext4 (rw) boostfs på /mnt/monteringspunkt Skriv fuse.boostfs (rw,nosuid,nodev)

I det här fallet är DD-fjärrlagringsenheten redan monterad under /mnt/mountpoint/ och kan därför inte monteras igen i samma katalog.


4. veckor DDBoostfs-fästet hänger sig (kan ta mer än 10 minuter att returnera)

Detta kan inträffa när en brandvägg mellan Linux-klienten och DD-målenheten släpper trafik till TCP-portarna 111 och 2049. Kontrollera att Linux-klienten kan nå DD till TCP-portarna 111 och 2049 och försök sedan igen, till exempel:

# /opt/emc/boostfs//bin/boostfs mount -d dd2500.domain.com -s LSU2 /mnt/mountpoint/

Det här är ett exempel på vad du skulle se i Linux-klientens BOOSTFS-loggar i ett sådant fall:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 27 juli 06:34:53 32762 3724339136 [E] bfs_conn_open: anslutningen misslyckades (0 anslutningar): 5037 27 juli 06:34:53 32762 3724339136 [E] bfs_conn_lookup: anslutningssökning misslyckades för nod 0-fil /.boostfs_sysinfo. (0 anslutningar) Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: Det gick inte att få en anslutning för fil /.boostfs_sysinfo 27 juli 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: initieringen misslyckades

5. Drift tillåts inte när du försöker komma åt eller lista innehåll under monteringspunkten

# ls -l /mnt/monteringspunkt/ LS: Läser katalog .: Drift ej tillåten Totalt 0

Problemet kan vara att det inte finns någon TCP-anslutning till DD-fjärrportarna 111 och 2049, eller att lockbox-autentiseringen på något sätt har upphört att gälla. Kontrollera att Linux-klienten fortfarande kan nå DD på de angivna portarna och försök konfigurera lockbox för fjärr-DD-, lagrings- och BOOST-användaren igen.


6. veckor Det finns ingen otillräcklig åtkomst till lagringsenheten med kerberos-autentisering.

# boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Otillräcklig åtkomst till eller lagringsenhet LSU3 finns inte

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 användarnamn Kundens huvudnamn: username@DOMAIN.COM Giltig start: Ti aug 23 11:02:49 2016 Upphör: ti aug 23 21:01:07 2016 Förnya till: Ti aug 30 11:02:49 2016 Tjänstens huvudnamn: krbtgt/DOMAIN. COM@DOMAIN.COM

I DDR kontrollerar du att den tilldelade BOOST-användaren till 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 exakt samma):

# ddboost-lagringsenhet show Status för förkontroll av namn (GiB) Användarrapport, fysisk klientorganisation Storlek (MiB) --------------- -------------- ------ -------- --------------- ----------- LSU3 0.0 RW användarnamn - - --------------- -------------- ------ -------- --------------- -----------

Var också noga med att bekräfta att datum/tid i DD, Linux-klienten och Kerberos-servern (AD) inte är mer än 5 minuter från varandra, annars kan problem med biljetter som upphört att gälla på grund av inkonsekvent tid uppstå.

Nedan visas ett exempel på vad vi skulle se i DD-loggarna om tiden var mer än 5 minuters skillnad:

# Logga titta på debug/ddfs.info 08/23 18:52:09.654 (tid 0x7f738141fb00): NFS3 accepteras 3000004b6 552 från 10.64.229.125:55042 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:117 – Händelse gss_error, gss_accept_sec_context misslyckades: maj=0xd0000, min=0x96c73a25 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 – händelse gss_error, ospecificerat GSS-fel. Mindre kod kan ge mer information 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 – händelse gss_error, för stor klockförskjutning 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 – Händelse gss_accept_failed, maj=851968, min2529638949 08/23 18:52:09.660 (tid 0x7f73814233f0): NFS3 förstörde TCP 3000004b6

Och det här är för BOOSTFS Linux-värdloggarna:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_open: anslutningen misslyckades (0 anslutningar): 5075 Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_lookup: anslutningssökning misslyckades för nod 0-fil /.boostfs_sysinfo. (0 anslutningar) Aug 23 18:04:39 1044 2019465280 [I] bfs_node_lookup: Det gick inte att få en anslutning för fil /.boostfs_sysinfo 23 aug 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: initieringen misslyckades

7.  Boostfs-montering med Kerberos-autentisering misslyckas med följande felmeddelande "Det går inte att komma åt lockbox eller lockbox-posten kan inte hittas" 

# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Det går inte att komma åt den säkra rutan eller så går det inte att hitta den säkra box-posten

 
Om du har för avsikt att använda konfigurationsalternativen för BOOSTFS i "/opt/emc/boostfs/etc/boostfs.conf" kontrollerar du inställningen "[global]" i filen och ser till att den inte är bortkommenterad (för att något av de globala alternativen ska fungera måste nyckelordet "[global]" vara okommenterat). Det här nyckelordet kommenteras som standard.

Exempelinnehåll i konfigurationsfilen BOOSTFS "/opt/emc/boostfs/etc/boostfs.conf":

# Kommentarer är inte tillåtna efter alternativvärdeparet. # ############################################################################# [globalt] # Data Domain: Värdnamn eller IP-adress # data-domain-system=dd2500.domain.com

Exempel på utdata som visas i Linux-klientens BOOSTFS-loggar:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 24 aug 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Det gick inte att hitta nyckelposten dd2500-rtp2.techsupp.local:LSU3 i konfigurationsfilen /opt/emc/boostfs/lockbox/boostfs.lockbox. Det gick inte att hitta den begärda Lockbox-posten. 24 aug 08:23:35 27227 3565582272 [E] bfs_conn_lookup: anslutningssökningen misslyckades för nod 0-filen /.boostfs_sysinfo. (0 anslutningar) Aug 24 08:23:35 27227 3565582272 [I] bfs_node_lookup: Det gick inte att hämta en anslutning för filen /.boostfs_sysinfo 24 aug 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: initieringen misslyckades

Felet kan också bero på att du använder ett annat värdnamn, lagringsenhetsnamn eller BOOST-användarnamn i Linux-klientens "mount"-kommando, jämfört med det som används för att konfigurera lockbox eller de som motsvarar mål-DD. Kontrollera att alla namn matchar i DD, BOOSTFS-lockbox och kommandot "mount".


8. veckor  Försöksuppsättningen "boostfs"-användaruppgifter misslyckas med följande fel :

bfs_krb5_err_handler: Kerberos-fel: -1765328360 [ERROR_MESSAGE=Det gick inte att hämta de första inloggningsuppgifterna.]

Det går inte att ställa in Kerberos-inloggningsuppgifter

1. Kontrollera att Active Directory-användarautentiseringsuppgifterna är korrekta genom att logga in på domänkontrollanten med Active Directory-användarautentiseringsuppgifter
2. Kontrollera att tiden 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.



9. veckor När du monterar BOOSTFS i Linux-klienten slutar det med felet "fusermount: mount failed: Drift är inte tillåten."

Detta kan bero på flera orsaker. "fusermount" är det underliggande Linux-kommando som slutligen 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 fil i Linux-klienten:

# ls -l /usr/bin/fusermount -rwsr-xr-x. 1 rotrot 38680 11 maj 2019 /usr/bin/fusermount

Att vara en SUID-binärfil innebär att oavsett vad användaren kör försöket att montera lagringsenheten, kommer "fusermount" att köras med "root"-privilegier. Om "fusermount" inte är SUID till root kan det hända att endast Linux-klientens rotanvändare kan montera fjärr-BOOST-lagringsenheten. Detta kanske inte är ett problem om du ställer in monteringen under /etc/fstab, men skulle vara när monteringen ska göras av en icke-root-användare.


10. veckor 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 antingen DataDomain-kommandot "boostfs" eller /etc/fstab (eller till och med "mount.fuse" från CLI) är det standardenhetens underliggande FUSE-implementering att endast tillåta åtkomst till filer till Linux-klientanvändar-ID:t som monterade BOOSTFS. Så om monteringen gjordes som root, kan endast root komma åt filerna. Om monteringen gjordes som användaren "postgres" (för säkerhetskopiering av en PostgreSQL-databas) skulle endast den här användaren ha behörighet att komma åt filerna.

Om man av olika anledningar vill att andra användare ska kunna komma åt filerna i den monterade lagringsenheten från Linux-molnet kan /etc/fuse.conf behöva justeras. Se mer information här:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Du måste ställa in följande alternativ i /etc/fuse.conf:

       user_allow_other
              Tillåt icke-root-användare att ange monteringsalternativen för allow_other eller allow_root (se
              nedan).
Använd sedan följande när du monterar BOOST-lagringsenheten från kommandoraden:
 

       allow_other
              Det här alternativet åsidosätter säkerhetsåtgärden som begränsar filåtkomsten för användaren
              montering av filsystemet.  Så alla användare (inklusive root) kan komma åt filerna.  Detta
              alternativet är som standard endast tillåtet att roota, men denna begränsning kan tas bort med
              Konfigurationsalternativet som beskrivs ovan (user_allow_other).

 

BOOSTFS-konfigurationsrelaterade frågor:

1. Vilket är det maximala antalet monteringspunktssektioner som man kan definiera i boostfs-konfigurationsfilen?
Det finns ingen gräns för antalet monteringar i avsnittet monteringspunkt i boostfs.conf-filen. 

# Monteringspunktssektioner separeras med [monteringspunkt]-taggar # # [/sökväg/till/montera] # [/mnt/bofs] # Data Domain: Värdnamn eller IP-adress # data-domain-system=dd2500-1.yourdomain.com # Förråd # storage-unit=su-name # Användarnamn för lagringsenhet # storage-unit-username=sysadmin # Underkatalog i lagringsenheten att montera på # directory-name=sökväg/till/subdir

2. Networker stöder BOOSTFS som standard och kan hantera monteringar i farten för att utföra vissa uppgifter och säkerhetskopieringar

Även om Networker är ett BOOST-aktiverat säkerhetskopieringsprogram stöder det även BOOSTFS på Linux-klientsystemen där det är installerat. Ett exempel på NW-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):Spara säkerhetskopierade data i poolen 'DB'. 175019:(PID 16487):Fick den bindande informationen om mediehanteringen på värden 'dd.example.com'. 174910:(pid 16487):Ansluten till nsrmmd-processen på värden 'dd.example.com'. + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain Bearbetningen fortsatte med det returnerade värdet 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/ Bearbetningen fortsatte med det returnerade värdet 0. Filerna i den sparade uppsättningen "PostgreSQL_postgres_backuppostgre_full" vid tiden "01/04/20 15:40:36" är: Storlek: Name: 2645 dump.sql 24000 postgresql.conf 2 fil(er) 26645 bytes Säkerhetskopieringskommandot "/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh" har slutförts. Säkerhetskopieringen har slutförts.

När säkerhetskopieringsjobbet har konfigurerats kan det också startas från NW GUI och förloppet övervakas där.messages.engineering visar loggposter som den nedan när monteringen som utfärdats av NW är klar:

1 apr 15:20:49 dd.example.com ddfs[17040]: ANMÄRKNING: ddboost-client.example.com-49808<>: BoostFS: Apr 1 15:22:52.395 16275 704915520 [jag] DDBoost Plugin Version är: [7.0.0.0.633508] 1 apr 15:20:49 dd.example.com ddfs[17040]: ANMÄRKNING: ddboost-client.example.com-49808<>: BoostFS: 1 apr 15:22:52.395 16275 704915520 [jag] BoostFS Version info: [BOOSTFS:7.0.0.0-633922 SÄKRING:2.9.7] 1 apr 15:20:49 dd.example.com ddfs[17040]: ANMÄRKNING: ddboost-client.example.com-49808<>: BoostFS: Apr 1 15:22:52.395 16275 704915520 [I] bfs_lib_init: Montering dd.example.com:LSU_NAME på /mnt/monteringspunkt