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

BOOSTFS er en programvarekomponent som kan installeres i noen operativsystemer, som gir muligheten til å kjøre BOOST-sikkerhetskopieringer til et DataDomain uten å bruke et bestemt sikkerhetskopieringsprogram, samtidig som du utnytter noen av funksjonene som følger med bruk av et BOOST-aktivert sikkerhetskopieringsprogram som Netbackup, Networker og Avamar.

Hvis du vil ha flere detaljer om installasjon og bruk rett på sak, kan du sjekke Data Domain: Fremskyndet konfigurasjonstrinn og detaljer for DataDomain BOOST FS KB-artikkel.

Denne kunnskapsartikkelen inneholder imidlertid noen av de typiske problemene som kan oppstå når du konfigurerer og bruker BOOSTFS, slik at kundene kan ha en hurtigreferanse for de typiske feilene, feilmeldingene og måten de kan løses på. Typiske slike feil vil være "Kan ikke installere Boostfs på Linux-server", "Boostfs-montering mislykkes med feil" eller "Sikkerhetskopiering eller gjenoppretting mislykkes med feil", for å nevne noen.

1. Påkrevd avhengighet mangler ved installasjon av BOOST FS-programvaren

Hvis det ikke oppstår en feil ved å installere den medfølgende RPM-programvaren for BOOSTFS-programvaren 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 >sikring = 2,8 sikring-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 at FUSE (Filesystem in USEr-rommet) binærfiler og biblioteker 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å.


2. Cannot mount /mnt/mountpoint/: uventet feil

Når du prøver å montere den eksterne DD-lagringsenheten lokalt i Linux-klienten gjennom BOOSTFS, kan du få feilen ovenfor. Se gjennom BOOSTFS-loggfilen i Linux-klienten. I det første eksemplet nedenfor inneholder for eksempel ikke låseboksfilen en oppføring for verten dd2500-abc.datadomain.com:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 29.07 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Finner ikke nøkkeloppføringen dd2500-abc.datadomain.com:LSU2 in config file /opt/emc/boostfs/lockbox/boostfs.lockbox. Den forespurte Lockbox-oppføringen ble ikke funnet. 29.07 03:45:25 22795 3267069888 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 tilkoblinger) 29.07 03:45:25 22795 3267069888 [I] bfs_node_lookup: klarte ikke å hente en tilkobling for filen /.boostfs_sysinfo 29.07 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: initialisering mislyktes

Løsningen i dette tilfellet vil være å legge til en låseboksoppføring for destinasjons-DD-verten og lagringsenheten som skal monteres lokalt. Syntaksen ligner på eksemplet nedenfor:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Angi brukerpassord for lagringsenhet: Skriv inn brukerpassordet for lagringsenheten på nytt for å bekrefte: Låseboksoppføringssett

En annen mulig feil som kan sees i de lokale BOOSTFS-klientloggene er at DD-vertsnavnet ikke løses fra klienten, for eksempel:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 29.07 04:05:50 22882 3322156992 [E] bfs_conn_open: connect failed (0 connections): 5037 29.07 04:05:50 22882 3322156992 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 tilkoblinger) 29.07 04:05:50 22882 3322156992 [I] bfs_node_lookup: failed to get connect for file /.boostfs_sysinfo 29.07 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: initialisering mislyktes

 
Løsningen i dette tilfellet vil være å enten legge til en statisk hosntame til IP-tilordning til Linux-klientens /etc/host-fil, eller konfigurere tilordningen i DNS-tjeneren som brukes.


3. Monteringspunktet /mnt/mountpoint er ikke tomt.
BoostFS kan ikke monteres på et monteringspunkt som ikke er tomt. Prøv montering på et tomt monteringspunkt.

Meldingen ovenfor betyr at monteringspunktet som er angitt (/mnt/mountpoint), ikke kan brukes til å vise den eksterne DD-lagringsenheten, siden monteringspunktet ikke kan ha et annet filsystem montert på det tidligere, eller har noe innhold. /mnt/mountpoint/ må være en tom og ubrukt mappe i Linux-klienten. Hvis banen allerede har en montering, må du spesifisere et annet monteringspunkt. Eksempel:

# mount /dev/mapper/vg00-lv_root on / type ext4 (rw) /dev/sda1 på /boot type ext4 (rw) boostfs på / mnt / mountpoint type fuse.boostfs (rw, nosuid, nodev)

I dette tilfellet er den eksterne DD-lagringsenheten allerede montert under /mnt/mountpoint/ og kan derfor ikke monteres på nytt i samme katalog.


4. DDBoostfs-montering henger (kan ta enda mer enn 10 minutter å returnere)

Dette kan skje når en brannmur mellom Linux-klienten og mål-DD-enheten slipper trafikk til TCP-portene 111 og 2049. Kontroller at Linux-klienten kan nå DD til TCP-port 111 og 2049, og prøv deretter på nytt, for eksempel:

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

Dette er et eksempel på hva du vil se i Linux-klienten BOOSTFS-logger i et slikt tilfelle:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 27.07 06:34:53 32762 3724339136 [E] bfs_conn_open: connect failed (0 connections): 5037 27.07 06:34:53 32762 3724339136 [E] bfs_conn_lookup: tilkoblingsoppslag mislyktes for node 0-fil /.boostfs_sysinfo. (0 tilkoblinger) 27.07 06:34:53 32762 3724339136 [I] bfs_node_lookup: klarte ikke å få en tilkobling for filen /.boostfs_sysinfo 27.07 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: initialisering mislyktes

5. Operasjon ikke tillatt når du prøver å få tilgang til eller føre opp innhold under monteringspunktet

# ls -l /mnt/mountpoint/ ls: lesing katalog .: Drift ikke tillatt Totalt 0

Problemet kan være at det ikke er noen TCP-tilkobling til de eksterne DD-portene 111 og 2049, eller at låseboksgodkjenningen på en eller annen måte er utløpt. Kontroller at Linux-klienten fortsatt kan nå til DD på de angitte portene, og prøv å konfigurere låseboksen for den eksterne DD-en, lagringsenheten og BOOST-brukeren på nytt.


6. Det finnes ikke tilstrekkelig tilgang til eller lagringsenhet ved hjelp av kerberos-godkjenning.

# boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Det finnes ikke tilstrekkelig tilgang til eller lagringsenhet LSU3 eksisterer ikke

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 Klientkontohaver: username@DOMAIN.COM Gyldig start: Tue Aug 23 11:02:49, 2016 Utløper: Tue Aug 23 21:01:07, 2016 Forny inntil: Tue Aug 30 11:02:49, 2016 Tjenestekontohaver: krbtgt/DOMENE. COM@DOMAIN.COM

På DDR kontrollerer du at den tilordnede BOOST-brukeren til 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 nøyaktig det samme):

# ddboost storage-unit show Navn på status for forhåndskontroll (GiB) Brukerrapport Fysisk leierenhet Størrelse (MiB) --------------- -------------- ------ -------- --------------- ----------- LSU3 0.0 RW brukernavn - - --------------- -------------- ------ -------- --------------- -----------

Pass også på å bekrefte at dato/klokkeslett i DD, Linux-klienten og Kerberos-serveren (AD) ikke er mer enn 5 minutter fra hverandre, eller problemer med billetter som er utløpt på grunn av inkonsekvent tid kan oppstå.

Nedenfor er et eksempel på hva vi ville se i DD-loggene hvis tiden var mer enn 5 minutters forskjell :

# logg se debug/ddfs.info 08/23 18:52:09.654 (tid 0x7f738141fb00): NFS3 godkjent 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 - hendelse gss_error, gss_accept_sec_context mislyktes: maj=0xd0000, min=0x96c73a25 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 - hendelse gss_error, Uspesifisert GSS-feil. Underordnet kode kan gi mer informasjon 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 - hendelse gss_error, klokkeskjevheten for stor 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 - hendelse gss_accept_failed, maj=851968, min2529638949 08/23 18:52:09.660 (tid 0x7f73814233f0): NFS3 ødelagt TCP 3000004B6

Og disse er for BOOSTFS Linux-vertsloggene:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 23. aug 18:04:39 1044 2019465280 [E] bfs_conn_open: connect failed (0 connections): 5075 23. aug 18:04:39 1044 2019465280 [E] bfs_conn_lookup: tilkoblingsoppslag mislyktes for node 0-fil /.boostfs_sysinfo. (0 tilkoblinger) 23. aug 18:04:39 1044 2019465280 [I] bfs_node_lookup: kunne ikke hente en tilkobling for fil /.boostfs_sysinfo 23 august 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: initialisering mislyktes

7.  Boostfs-montering med Kerberos-godkjenning mislykkes med følgende feilmelding: «Finner ingen tilgang til låseboks eller låseboksoppføring finner ikke» 

# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Finner ingen tilgang til lockbox eller lockbox-oppføring

 
Hvis du har tenkt å bruke BOOSTFS-konfigurasjonsalternativer i "/opt/emc/boostfs/etc/boostfs.conf", må du kontrollere "[global]"-innstillingen i filen, og sørge for at den ikke blir kommentert ut (for at noen av de globale alternativene skal fungere, må nøkkelordet "[global]" være ukommentert). Dette søkeordet er kommentert som standard.

Eksempel på innholdet i BOOSTFS-konfigurasjonsfilen «/opt/emc/boostfs/etc/boostfs.conf»:

# Kommentarer er ikke tillatt etter alternativverdiparet. # ############################################################################# [Global] # Data Domain-vertsnavn eller IP-adresse # data-domain-system=dd2500.domain.com

Eksempel på utdata som du vil se i BOOSTFS-loggene for Linux-klienten:

# mindre /opt/emc/boostfs/log/ddboostfs_0_0.log 24 aug 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Failed to find key entry dd2500-rtp2.techsupp.local:LSU3 in config file /opt/emc/boostfs/lockbox/boostfs.lockbox. Den forespurte Lockbox-oppføringen ble ikke funnet. 24. aug 08:23:35 27227 3565582272 [E] bfs_conn_lookup: tilkoblingsoppslag mislyktes for node 0-fil /.boostfs_sysinfo. (0 tilkoblinger) 24 aug 08:23:35 27227 3565582272 [I] bfs_node_lookup: Klarte ikke å få en tilkobling for filen /.boostfs_sysinfo 24. aug 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: initialisering mislyktes

Feilen kan også være et resultat av å bruke et annet vertsnavn, lagringsenhetsnavn eller BOOST-brukernavn i Linux-klientens "mount" -kommando, sammenlignet med som brukes til å sette opp låseboksen, eller de som tilsvarer mål-DD. Kontroller at alle navnene samsvarer på tvers av DD, BOOSTFS-låseboksen og monteringskommandoen.


8.  Forsøk på å angi boostfs-brukerlegitimasjon mislykkes med følgende feil :

bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Kunne ikke hente innledende legitimasjon.]

Kan ikke angi Kerberos-legitimasjon

1. Kontroller at brukerlegitimasjonen for Active Directory er riktig ved å logge på DC med Active Directory-brukerlegitimasjon
2. Kontroller at det ikke er mer enn 5 minutter fra Linux-klienten og Kerberos-serveren. Kerberos-godkjenning krever at klokketidene ikke er mer enn 5 minutter fra hverandre.



9. Når du monterer BOOSTFS i Linux-klienten, slutter den med feil "fusermount: mount failed: Drift ikke tillatt."

Dette kan skyldes en rekke årsaker. "fusermount" er den underliggende Linux-kommandoen som til slutt bruker FUSE til å montere DD BOOST-lagringsenheten lokalt i Linux-klientnavneområdet. Dette krever spesielle privilegier. Derfor er "fusermount" en SUID-binær i Linux-klienten:

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

Å være en SUID-binær betyr at uansett hva brukeren kjører forsøket på å montere lagringsenheten, vil "fusermount" kjøre med "root"-privilegier. Hvis "fusermount" ikke er SUID til rot, er det bare Linux-klientrotbrukeren som kan montere den eksterne BOOST-lagringsenheten. Dette er kanskje ikke noe problem hvis du setter opp monteringen under /etc/fstab, men det vil være når monteringen skal gjøres av en ikke-rotbruker.


10. 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 DataDomain "boostfs"-kommandoen eller /etc/fstab (eller til og med "mount.fuse" fra CLI), er det standardens underliggende sikringsimplementering å bare tillate tilgang til filer til Linux-klientbruker-ID-en 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 DB), ville bare denne brukeren ha tillatelse til å få tilgang til filene.

Hvis man av forskjellige grunner trenger andre brukere for å kunne få tilgang til filene i den monterte lagringsenheten fra Linux-skyen, kan det hende at /etc/fuse.conf må stilles inn. Se flere detaljer her:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Du må angi følgende alternativ i /etc/fuse.conf:

       user_allow_other
              Tillat at ikke-rotbrukere angir monteringsalternativer for allow_other eller allow_root (se
              nedenfor).
Og bruk deretter følgende når du monterer BOOST-lagringsenheten, fra kommandolinjen:
 

       allow_other
              Dette alternativet overstyrer sikkerhetstiltaket som begrenser filtilgang til brukeren
              montering av filsystemet.  Så alle brukere (inkludert root) kan få tilgang til filene.  Dette
              Alternativet er som standard bare tillatt å rotere, men denne begrensningen kan fjernes med
              Konfigurasjonsalternativet beskrevet ovenfor (user_allow_other).

 

BOOSTFS-konfigurasjonsrelaterte spørsmål:

1. Hva er maksimalt antall monteringspunktseksjoner man kan definere i boostfs-konfigurasjonsfilen?
Det er ingen grense for antall fester i monteringspunktdelen av boostfs.conf-filen. 

# Monteringspunktseksjoner er atskilt med [mountpoint]-koder # # [/path/to/mount] # [/mnt/bofs] # Data Domain-vertsnavn eller IP-adresse # data-domain-system=dd2500-1.yourdomain.com # Lagringsenhet # storage-unit=su-name # Brukernavn for lagringsenhet # storage-unit-username=sysadmin # Underkatalog i lagringsenheten som skal monteres på # katalognavn=bane/til/subdir

2. Networker støtter BOOSTFS som standard, og kan håndtere on-the-fly monteringer for å utføre visse oppgaver og sikkerhetskopier

Selv om Networker er et BOOST-aktivert sikkerhetskopieringsprogram, støtter det også BOOSTFS på Linux-klientsystemene der det er installert. Et eksempel på NW-sikkerhetskopiering hentet fra Linux-klientens kommandolinje, når BOOSTFS-låseboksen er konfigurert, vil være følgende (PostgreSQL-sikkerhetskopi):

# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg 174908:(pid 16487):Lagre sikkerhetskopidataene i bassenget 'DB'. 175019:(pid 16487):Mottok mediehåndteringsbindende informasjon om verten 'dd.example.com'. 174910:(pid 16487):Koblet til nsrmmd-prosessen på verten 'dd.example.com'. + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=plain Fortsatt behandling med den returnerte verdien 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/ Fortsatt behandling med den returnerte verdien 0. Filene i lagringssettet 'PostgreSQL_postgres_backuppostgre_full' på tidspunktet '01/04/20 15:40:36' er: Størrelse: Name: 2645 dump.sql 24000 postgresql.conf 2 fil(er) 26645 byte Sikkerhetskopikommandoen '/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh' er fullført. Sikkerhetskopieringen er fullført.

Når sikkerhetskopieringsjobben er konfigurert, kan den også startes fra NW GUI og fremdriften overvåkes der.messages.engineering vil vise loggoppføringer som den nedenfor når monteringen utstedt av NW er ferdig:

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