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

BOOSTFS er en softwarekomponent, der kan installeres i nogle operativsystemer, som giver mulighed for at køre BOOST-sikkerhedskopier til et DataDomain uden at bruge et bestemt sikkerhedskopieringsprogram, samtidig med at det udnytter nogle af de funktioner, der følger med ved hjælp af et BOOST-aktiveret sikkerhedskopieringsprogram såsom Netbackup, Neter og Avamar.

Du kan finde flere oplysninger om installation og anvendelse "lige til sagen" i Data Domain: Fremskyndede konfigurationstrin og detaljer for DataDomain BOOST FS KB-artikel.

Denne KB indeholder dog nogle af de typiske problemer, der kan findes, når du konfigurerer og bruger BOOSTFS, så kunderne kan få en hurtig reference til disse typiske fejl, fejlmeddelelser og måden at løse dem på. Typiske sådanne fejl ville være "Kan ikke installere Boostfs på Linux-server", "Boostfs-montering mislykkes med fejl" eller "Sikkerhedskopiering eller gendannelse mislykkes med fejl" for at nævne nogle få.

1. Påkrævet afhængighed mangler ved installation af BOOST FS-softwaren

Hvis der ikke er nogen fejl i installationen af 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 sikring >= 2,8 sikrings-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, at binære filer og biblioteker i FUSE (Filsystem i USEr-rum) installeres (BOOSTFS er baseret på Linux' FUSE), samt enhver pakke, der leverer en shell (sh) og standard RPM-bibliotekerne. Derfor bør denne BOOSTFS-pakke installeres normalt i Linux-systemet, hvor "rpm" er blevet kørt på.


2. Kan ikke montere /mnt/mountpoint/: uventet fejl

Når du forsøger at montere den eksterne DD-lagerenhed lokalt i Linux-klienten via BOOSTFS, kan du få fejlen ovenfor. Gennemse BOOSTFS-logfilen i Linux-klienten. I det første eksempel nedenfor indeholder lockbox-filen f.eks. ikke en post for værten dd2500-abc.datadomain.com:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 29 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Kunne ikke finde nøgleposten dd2500-abc.datadomain.com:LSU2 i konfigurationsfilen /opt/emc/boostfs/lockbox/boostfs.lockbox. Den anmodede Lockbox-post blev ikke fundet. Jul 29 03:45:25 22795 3267069888 [E] bfs_conn_lookup: forbindelsesopslag mislykkedes for node 0-fil /.boostfs_sysinfo. (0 forbindelser) Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: kunne ikke få forbindelse til fil /.boostfs_sysinfo Jul 29 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: initialisering mislykkedes

Løsningen i dette tilfælde ville være at tilføje en lockbox-post for destinations-DD-værten og lagerenheden, der skal monteres lokalt. Syntaks ligner eksemplet nedenfor:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Indtast brugeradgangskode til storageenheden: Indtast brugeradgangskoden til storageenheden igen for at bekræfte: Nøgleboksindgangssæt

En anden mulig fejl, der kan ses i de lokale BOOSTFS-klientlogfiler, er, at DD-værtsnavnet ikke løses fra klienten, f.eks.:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_open: tilslutning mislykkedes (0 forbindelser): 5037 Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_lookup: forbindelsesopslag mislykkedes for node 0-fil /.boostfs_sysinfo. (0 forbindelser) Jul 29 04:05:50 22882 3322156992 [I] bfs_node_lookup: kunne ikke få forbindelse til filen /.boostfs_sysinfo Jul 29 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: initialisering mislykkedes

 
Løsningen i dette tilfælde ville være enten at tilføje en statisk hosntame til IP-kortlægning til Linux-klientens /etc/host-fil eller konfigurere kortlægningen på den DNS-server, der bruges.


3. Monteringspunktet /mnt/monteringspunktet er ikke tomt.
BoostFS kan ikke monteres på et ikke-tomt monteringspunkt. Prøv at montere på et tomt monteringspunkt.

Ovenstående meddelelse betyder, at det angivne monteringspunkt (/mnt/mountpoint) ikke kan bruges til at vise den eksterne DD-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 montering, skal du angive et andet tilslutningspunkt. F.eks.:

# montere /dev/mapper/vg00-lv_root on / type ext4 (rw) /dev/SDA1 til/starttype ext4 (RW) boostFS på /mnt/monteringspunkt type fuse.boostfs (rw, nosuid, nodev)

I dette tilfælde er DD-fjernlagerenheden allerede monteret under /mnt/mountpoint/ og kan derfor ikke monteres igen i samme mappe.


4. DDBoostfs mount hangs (kan tage endnu mere end 10 minutter at vende tilbage)

Dette kan opstå, når en firewall mellem Linux-klienten og destinations-DD-enheden slipper trafik til TCP-port 111 og 2049. Sørg for, at Linux-klienten kan nå DD til TCP-portene 111 og 2049, og prøv derefter igen, for eksempel:

# /opt/emc/boostfs//bin/boostfs-montering -d dd2500.domain.com -s LSU2 /mnt/monteringspunkt/

Dette er et eksempel på, hvad du ville se i Linux-klientens BOOSTFS-logfiler i et sådant tilfælde:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_open: tilslutning mislykkedes (0 forbindelser): 5037 Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_lookup: forbindelsesopslag mislykkedes for node 0-fil /.boostfs_sysinfo. (0 forbindelser) Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: kunne ikke hente en forbindelse til fil /.boostfs_sysinfo Jul 27 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: initialisering mislykkedes

5. Betjening er ikke tilladt, når du forsøger at få adgang til eller angive indhold under monteringspunktet

# ls -l /mnt/monteringspunkt/ LS: Læsning Directory .: Drift ikke tilladt I alt 0

Problemet kan være, at der ikke er nogen TCP-forbindelse til DD-fjernportene 111 og 2049, eller at lockbox-godkendelsen på en eller anden måde er udløbet. Sørg for, at Linux-klienten stadig kan nå til DD på de angivne porte, og prøv at konfigurere lockboxen for den eksterne DD, lagerenheden og BOOST-brugeren igen.


6. Der er ikke tilstrækkelig adgang til eller ikke adgang til storageenheden ved brug af Kerberos-godkendelse.

# boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Utilstrækkelig adgang til eller lagerenhed LSU3 findes ikke

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 forespørgsel -s LSU3 -u brugernavn Klientprincippet: username@DOMAIN.COM Gyldig start: Tue Aug 23 11:02:49 2016 Udløber: Tue Aug 23 21:01:07 2016 Forny indtil: Tue Aug 30 11:02:49 2016 Tjenesteprincipal: krbtgt/DOMÆNE. COM@DOMAIN.COM

På DDR skal du kontrollere, at den tildelte BOOST-bruger til storage-enheden matcher brugeren på Linux-klienten, når lockboxen konfigureres og BOOSTFS monteres (AD-brugernavnet og lagerenhedens brugernavn skal være nøjagtigt det samme):

# ddboost storage-enhed show Navn Pre-Comp (GiB) Status Brugerrapport Fysisk lejer-enhed Størrelse (MiB) --------------- -------------- ------ -------- --------------- ----------- LSU3 0.0 RW brugernavn - - --------------- -------------- ------ -------- --------------- -----------

Sørg også for at bekræfte, at dato / klokkeslæt i DD, Linux-klienten og Kerberos-serveren (AD) ikke er mere end 5 minutter fra hinanden, eller problemer med billetter, der er udløbet på grund af inkonsekvent tid, kan forekomme.

Nedenfor er et eksempel på, hvad vi ville se i DD-logfilerne, hvis tiden var mere end 5 minutters forskel :

# log se fejlfinding / ddfs.info 08/23 18:52:09.654 (TID 0x7f738141fb00): NFS3 accepteret 3000004B6 552 fra 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 mislykkedes: 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, uspecificeret GSS-fejl. Mindre kode kan give flere oplysninger 08/23 18:52:09.660 (TID 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 - begivenhed gss_error, uret skævt for stort 08/23 18:52:09.660 (TID 0x7f738140c890): [dd_rpc2_nfs x3000004B6] dd_rpc_gss_accept:217 - Begivenhed gss_accept_failed, maj=851968, min2529638949 08/23 18:52:09.660 (TID 0x7f73814233f0): NFS3 ødelagt TCP 3000004B6

Og disse er til BOOSTFS Linux-værtslogfiler:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_open: tilslutning mislykkedes (0 forbindelser): 5075 Aug 23 18:04:39 1044 2019465280 [E] bfs_conn_lookup: forbindelsesopslag mislykkedes for node 0-fil /.boostfs_sysinfo. (0 forbindelser) Aug 23 18:04:39 1044 2019465280 [I] bfs_node_lookup: kunne ikke få forbindelse til fil /.boostfs_sysinfo Aug 23 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: initialisering mislykkedes

7.  BoostFS-montering med Kerberos-godkendelse mislykkes med følgende fejl: "Der blev ikke fundet adgang til adgang til lockbox- eller lockbox-post" 

# /opt/emc/boostfs/bin/boostfs-montering -s LSU3 -d dd2500.domain.com /mnt/monteringspunkt/ Der blev ikke fundet adgang til adgang til nøgleboks eller nøgleboks

 
Hvis du har tænkt dig at bruge BOOSTFS-konfigurationsindstillinger i "/opt/emc/boostfs/etc/boostfs.conf", skal du kontrollere indstillingen "[global]" i filen og sørge for, at den ikke kommenteres (for at nogen af de globale indstillinger skal fungere, skal nøgleordet "[global]" ikke kommenteres). Dette nøgleord kommenteres som standard.

Eksempel på indhold af konfigurationsfilen "/opt/emc/boostfs/etc/boostfs.conf":

# Kommentarer er ikke tilladt efter indstillingsværdiparret. # ############################################################################# [global] # Data Domain-værtsnavn eller IP-adresse # data-domain-system=dd2500.domain.com

Eksempel på output, som du vil se i Linux-klientens BOOSTFS-logfiler:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log Aug 24 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Kunne ikke finde nøgleposten dd2500-rtp2.techsupp.local:LSU3 i konfigurationsfilen /opt/emc/boostfs/lockbox/boostfs.lockbox. Den anmodede Lockbox-post blev ikke fundet. Aug 24 08:23:35 27227 3565582272 [E] bfs_conn_lookup: forbindelsesopslag mislykkedes for node 0-fil /.boostfs_sysinfo. (0 forbindelser) Aug 24 08:23:35 27227 3565582272 [I] bfs_node_lookup: kunne ikke få forbindelse til fil /.boostfs_sysinfo Aug 24 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: initialisering mislykkedes

Fejlen kan også være resultatet af at bruge et andet værtsnavn, lagerenhedsnavn eller BOOST-brugernavn i Linux-klientens "mount"-kommando sammenlignet med dem, der bruges til opsætning af lockboxen, eller dem, der svarer til mål-DD. Sørg for, at alle navne stemmer overens på tværs af DD, BOOSTFS-lockbox og kommandoen "mount".


8.  Brugerlegitimationsoplysningerne for "boostfs" forsøgsættes mislykkes med følgende fejl :

bfs_krb5_err_handler: Kerberos-fejl: -1765328360 [ERROR_MESSAGE=Første legitimationsoplysninger kunne ikke opnås.]

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ættet på Linux-klienten og Kerberos-serveren. Kerberos-godkendelse kræver, at der ikke er mere end 5 minutters mellemrum mellem uret.



9. Når du monterer BOOSTFS i Linux-klienten, slutter det med fejlen "fusermount: mount failed: Operation ikke tilladt."

Dette kan skyldes en række årsager. "fusermount" er den underliggende Linux-kommando, som i sidste ende bruger FUSE til at montere DD BOOST-lagerenheden lokalt i Linux-klientnavneområdet. Det kræver særlige privilegier. Derfor er "fusermount" en SUID-binær i Linux-klienten:

# ls -l /usr/bin/fusermount -RWSR-XR-X. 1 rodrod 38680, 11. maj 2019 /usr/bin/fusermount

At være en SUID-binær betyder, at uanset hvad brugeren kører forsøget på at montere lagerenheden, vil "fusermount" køre med "root" -rettigheder. Hvis "fusermount" ikke er SUID til root, er det muligvis kun Linux-klientens root-bruger, der kan tilslutte den eksterne BOOST-lagerenhed. Dette er muligvis ikke et problem, hvis monteringen konfigureres under /etc/fstab, men det vil være, når monteringen skal udføres af en ikke-root-bruger.


10. BOOSTFS-monteringer OK, men forsøg på at få adgang til lagerenhedens indhold på tilslutningspunktet mislykkes med tilladelsesfejl

Når du monterer storageenheden manuelt ved hjælp af enten DataDomain "boostfs"-kommandoen eller /etc/fstab (eller endda "mount.fuse" fra CLI), er det standardens underliggende FUSE-implementering, der kun tillader adgang til filer til Linux-klientbrugid'et, som monterede BOOSTFS. Så hvis monteringen blev lavet som root, kan kun root få adgang til filerne. Hvis tilslutningen blev foretaget som brugeren "postgres" (til sikkerhedskopiering af en PostgreSQL DB), er det kun denne bruger, der har tilladelse til at få adgang til filerne.

Hvis man af forskellige årsager har brug for, at andre brugere kan få adgang til filerne i den monterede lagerenhed fra Linux-skyen, skal /etc/fuse.conf muligvis indstilles. Se flere detaljer her:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Du skal indstille følgende mulighed i /etc/fuse.conf:

       user_allow_other
              Tillad ikke-root-brugere at angive allow_other eller allow_root monteringsindstillinger (se
              nedenfor).
Og brug derefter den følgende, når du monterer BOOST-storageenheden, fra kommandolinjen:
 

       allow_other
              Denne indstilling tilsidesætter den sikkerhedsforanstaltning, der begrænser filadgangen til brugeren
              montering af filsystemet.  Så alle brugere (inklusive root) kan få adgang til filerne.  Denne
              Indstillingen er som standard kun tilladt at rodfæste, men denne begrænsning kan fjernes med
              Konfigurationsindstillingen beskrevet ovenfor (user_allow_other).

 

Spørgsmål om BOOSTFS-konfiguration:

1. Hvad er det maksimale antal monteringspunktsektioner, man kan definere i boostfs-konfigurationsfilen?
Der er ingen grænse for antallet af tilslutninger i afsnittet om monteringspunkter i filen boostfs.conf. 

# Mount point sektioner er adskilt af [mountpoint] tags # # [/sti/til/til-montering] # [/mnt/bofs] # Data Domain-værtsnavn eller IP-adresse # data-domain-system=dd2500-1.yourdomain.com # Opbevaringsrum # storage-unit=su-name # Brugernavn til lagerenhed # storage-unit-brugernavn = sysadmin # Undermappe i lagerenheden til montering på # bibliotek-navn = sti / til / subdir

2. NetWorker understøtter som standard BOOSTFS og kan håndtere monteringer på farten til udførelse af visse opgaver og sikkerhedskopier

Selvom Networker er et BOOST-aktiveret sikkerhedskopieringsprogram, understøtter det også BOOSTFS på de Linux-klientsystemer, hvor det er installeret. Et eksempel på NW-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):Lagring af sikkerhedskopidata i puljen 'DB'. 175019:(pid 16487):Modtog mediehåndteringens bindende oplysninger om værtens 'dd.example.com'. 174910:(pid 16487):Forbundet til nsrmmd-processen på værten 'dd.example.com'. + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain Fortsat behandling med den returnerede værdi 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/ Fortsat behandling med den returnerede værdi 0. Filerne i gemmesættet 'PostgreSQL_postgres_backuppostgre_full' på tidspunktet '01/04/20 15:40:36' er: Størrelse: Navn: 2645 dump.sql 24000 postgresql.conf 2 Fil(er): 26645 bytes Sikkerhedskopieringskommandoen "/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh" fuldført. Sikkerhedskopieringen blev fuldført.

Når sikkerhedskopieringsjobbet er konfigureret, kan det også startes fra NW GUI, og fremskridt overvåges der.messages.engineering viser logposter som den nedenfor, når monteringen udstedt af NW er færdig:

1 apr 15:20:49 dd.example.com ddfs[17040]: BEMÆRK: ddboost-client.example.com-49808<>: BoostFS: Apr 1 15:22:52.395 16275 704915520 [I] DDBoost Plugin Version er: [7.0.0.0.633508] 1 apr 15:20:49 dd.example.com ddfs[17040]: BEMÆRK: ddboost-client.example.com-49808<>: BoostFS: 1 apr 15:22:52.395 16275 704915520 [I] BoostFS Version info: [BOOSTFS:7.0.0.0-633922 SIKRING:2.9.7] 1 apr 15:20:49 dd.example.com ddfs[17040]: BEMÆRK: ddboost-client.example.com-49808<>: BoostFS: 1 apr 15:22:52.395 16275 704915520 [I] bfs_lib_init: Montering dd.example.com:LSU_NAME på /mnt/monteringspunkt