Data Domain: Problemen met installatie, configuratie en koppeling van Boostfs oplossen

BOOSTFS is een softwarecomponent die in sommige besturingssystemen kan worden geïnstalleerd en die de mogelijkheid biedt om BOOST-back-ups naar een DataDomain uit te voeren zonder een bepaalde back-upapplicatie te gebruiken, terwijl tegelijkertijd enkele van de functies worden gebruikt die worden geleverd met het gebruik van een BOOST-back-upapplicatie zoals Netbackup, Networker en Avamar.

Raadpleeg voor meer "to the point" installatie- en gebruiksgegevens het Data Domain: Versnelde configuratiestappen en details voor DataDomain BOOST FS KB-artikel.

Dit KB-artikel bevat echter enkele van de typische problemen die kunnen optreden bij het configureren en gebruiken van BOOSTFS, zodat klanten snel een referentie hebben voor deze typische fouten, foutmeldingen en de manier om ze op te lossen. Typische dergelijke foutmeldingen zijn "Kan Boostfs niet installeren op Linux-server", "Boostfs-mount mislukt met fout" of "Back-up of herstel mislukt met fout", om er maar een paar te noemen.

1. Vereiste afhankelijkheid ontbreekt bij het installeren van de BOOST FS-software

Als het installeren van de opgegeven BOOSTFS-software-RPM op het Linux-besturingssysteem van de client mislukt, moet u eerst bepalen wat de vereiste pakketafhankelijkheden voor de BOOSTFS-software zijn:

# rpm -qpR DDBoostFS-1.0.0.1-539441.rhel.x86_64.rpm >zekering = 2.8 zekering-libs >= 2.8 /bin/sh /bin/sh /bin/sh /bin/sh rpmlib(PayloadFilesHavePrefix) <= 4.0-1 rpmlib(CompressedFileNames) <= 3.0.4-1

In het bovenstaande voorbeeld vraagt het pakket om de FUSE (Filesystem in USEr space) binaries en libraries te installeren (BOOSTFS is gebaseerd op Linux's FUSE), evenals elk pakket dat een shell (sh) en de standaard RPM-bibliotheken levert. Daarom zou dit BOOSTFS-pakket normaal moeten worden geïnstalleerd in het Linux-systeem waarop de "rpm" is uitgevoerd.


2. okt. Kan /mnt/mountpoint/ niet koppelen: onverwachte fout

Wanneer u de externe DD-opslageenheid lokaal in de Linux-client probeert te koppelen via BOOSTFS, krijgt u mogelijk de bovenstaande fout. Controleer het BOOSTFS-logbestand in de Linux-client. In het eerste voorbeeld hieronder bevat het lockbox-bestand bijvoorbeeld geen vermelding voor de host-dd2500-abc.datadomain.com:

# less /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 29 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Kan de sleutelvermelding dd2500-abc.datadomain.com:LSU2 niet vinden in het configuratiebestand /opt/emc/boostfs/lockbox/boostfs.lockbox. De aangevraagde Lockbox-vermelding kan niet worden gevonden. Jul 29 03:45:25 22795 3267069888 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 aansluitingen) Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: failed to get a connection for file /.boostfs_sysinfo Jul 29 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: initialization failed

De oplossing in dit geval zou zijn om een lockbox-ingang toe te voegen voor de bestemming DD-host en -opslageenheid die lokaal moeten worden gemonteerd. De syntaxis zou vergelijkbaar zijn met het onderstaande voorbeeld:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Voer het gebruikerswachtwoord van de storage-eenheid in: Voer het gebruikerswachtwoord van de storage-eenheid opnieuw in om te bevestigen: Lockbox-invoerset

Een andere mogelijke fout die kan worden gezien in de lokale BOOSTFS-clientlogboeken is dat de DD-hostnaam niet wordt omgezet vanuit de client, bijvoorbeeld:

# 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 aansluitingen) Jul 29 04:05:50 22882 3322156992 [I] bfs_node_lookup: failed to get a connection for file /.boostfs_sysinfo Jul 29 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: initialization failed

 
De oplossing zou in dit geval zijn om ofwel een statisch hosntame toe te voegen aan IP-toewijzing aan het /etc/host-bestand van de Linux-client, of de toewijzing te configureren in de DNS-server die wordt gebruikt.


3. okt. Het koppelpunt /mnt/mountpoint is niet-leeg.
BoostFS kan niet op een niet-leeg bevestigingspunt worden gemonteerd. Probeer de montage op een leeg bevestigingspunt.

Het bovenstaande bericht betekent dat het opgegeven koppelpunt (/mnt/mountpoint) niet kan worden gebruikt om de externe DD-storage-eenheid weer te geven, omdat op het koppelpunt niet eerder een ander bestandssysteem kan zijn gekoppeld of inhoud kan bevatten. /mnt/mountpoint/ moet een lege en ongebruikte map zijn in de Linux-client. Als het pad al een koppeling heeft, moet u een ander koppelingspunt opgeven. Bijvoorbeeld:

# monteren /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)

In dit geval is de externe DD-storage-eenheid al gekoppeld onder /mnt/mountpoint/ en kan daarom niet opnieuw in dezelfde map worden gekoppeld.


4. okt. DDBoostfs mount hungs (kan zelfs meer dan 10 minuten duren om terug te keren)

Dit kan gebeuren wanneer een firewall tussen de Linux-client en het doel-DD-apparaat verkeer naar TCP-poorten 111 en 2049 laat vallen. Zorg ervoor dat de Linux-client de DD naar TCP-poorten 111 en 2049 kan bereiken en probeer het opnieuw, bijvoorbeeld:

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

Dit is een voorbeeld van wat je in zo'n geval zou zien in de BOOSTFS-logs van de Linux-client:

# 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 aansluitingen) Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: failed to get a connection for file /.boostfs_sysinfo Jul 27 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: initialization failed

5. Bewerking niet toegestaan bij het openen of weergeven van inhoud onder het koppelpunt

# ls -l /mnt/mountpoint/ LS: Leesmap.: Bediening niet toegestaan totaal 0

Het probleem kan zijn dat er geen TCP-connectiviteit is met de externe DD-poorten 111 en 2049, of dat de lockbox-authenticatie op de een of andere manier is verlopen. Zorg ervoor dat de Linux-client nog steeds het DD op de opgegeven poorten kan bereiken en probeer de lockbox voor de externe DD, storage-eenheid en BOOST-gebruiker opnieuw in te stellen.


6. okt. Onvoldoende toegang tot of storage-eenheid bestaat niet bij gebruik van kerberos-authenticatie.

# boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Onvoldoende toegang tot of opslageenheid LSU3 bestaat niet

Wanneer u Kerberos-authenticatie voor de lockbox gebruikt, is de meest waarschijnlijke reden voor de fout dat het Kerberos-authenticatieticket is verlopen. Controleer het genoemde ticket van Linux, zoals hieronder:

# /opt/emc/boostfs/bin/boostfs kerberos query -s LSU3 -u username Client Principal: username@DOMAIN.COM Geldig begin: Tue Aug 23 11:02:49 2016 Verloopt: Tue Aug 23 21:01:07 2016 Verlengen tot: Tue Aug 30 11:02:49 2016 Service Principal: krbtgt/DOMAIN. COM@DOMAIN.COM

Controleer op de DDR of de toegewezen BOOST-gebruiker aan de storage-eenheid overeenkomt met de gebruiker op de Linux-client bij het instellen van de lockbox en het koppelen van BOOSTFS (de AD-gebruikersnaam en de gebruikersnaam van de storage-eenheid moeten exact hetzelfde zijn):

# ddboost storage-unit show Naam Pre-Comp (GiB) Status Gebruikersrapport Fysieke tenant-eenheid Grootte (MiB) --------------- -------------- ------ -------- --------------- ----------- LSU3 0.0 RW gebruikersnaam - - --------------- -------------- ------ -------- --------------- -----------

Controleer ook of de datum/tijd in het DD-apparaat, de Linux-client en de Kerberos-server (AD) niet meer dan 5 minuten uit elkaar liggen, anders kunnen er problemen optreden met verlopen tickets als gevolg van inconsistente tijd.

Hieronder ziet u een voorbeeld van wat we in de DD-logboeken zouden zien als de tijd meer dan 5 minuten verschil was:

# log watch debug/ddfs.info 08/23 18:52:09.654 (TID 0x7f738141fb00): NFS3 geaccepteerd 3000004b6 552 van 10.64.229.125:55042 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:117 - gebeurtenis gss_error, gss_accept_sec_context mislukt: maj=0xd0000, min=0x96c73a25 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 - gebeurtenis gss_error, niet-gespecificeerde GSS-fout. Kleine code kan meer informatie geven 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 - gebeurtenis gss_error, Klok scheef te groot 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 vernietigd TCP 3000004b6

Dit zijn voor de BOOSTFS Linux host logs:

# 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 aansluitingen) Aug 23 18:04:39 1044 2019465280 [I] bfs_node_lookup: failed to get a connection for file /.boostfs_sysinfo Aug 23 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: initialization failed

7.  Boostfs-koppeling met Kerberos-authenticatie mislukt met de volgende foutmelding: "Geen toegang tot lockbox of lockbox-item kan niet worden gevonden" 

# /opt/emc/boostfs/bin/boostfs mount -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Geen toegang tot lockbox of lockbox-ingang kan niet worden gevonden

 
Als u van plan bent om de BOOSTFS-configuratieopties in "/opt/emc/boostfs/etc/boostfs.conf" te gebruiken, controleer dan de instelling "[global]" in het bestand en zorg ervoor dat er geen commentaar op wordt gegeven (om een van de algemene opties te laten werken, moet het sleutelwoord "[global]" geen commentaar krijgen). Dit trefwoord wordt standaard becommentarieerd.

Voorbeeldinhoud van het BOOSTFS-configuratiebestand "/opt/emc/boostfs/etc/boostfs.conf":

# Reacties zijn niet toegestaan na het optiewaardepaar. # ############################################################################# [wereldwijd] # Data Domain Hostnaam of IP-adres # data-domain-system=dd2500.domain.com

Voorbeelduitvoer die u zou zien in de BOOSTFS-logboeken van de Linux-client:

# less /opt/emc/boostfs/log/ddboostfs_0_0.log Aug 24 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Kan sleutelvermelding dd2500-rtp2.techsupp.local:LSU3 niet vinden in het configuratiebestand /opt/emc/boostfs/lockbox/boostfs.lockbox. De aangevraagde Lockbox-vermelding kan niet worden gevonden. Aug 24 08:23:35 27227 3565582272 [E] bfs_conn_lookup: connection lookup failed for node 0 file /.boostfs_sysinfo. (0 aansluitingen) Aug 24 08:23:35 27227 3565582272 [I] bfs_node_lookup: failed to get a connection for file /.boostfs_sysinfo Aug 24 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: initialization failed

De fout kan ook het gevolg zijn van het gebruik van een andere hostnaam, storage-eenheidsnaam of BOOST-gebruikersnaam in de "mount"-opdracht van de Linux-client in vergelijking met de lockbox die wordt gebruikt voor het instellen van de lockbox, of degene die overeenkomen met het doel-DD. Zorg ervoor dat alle namen overeenkomen in het DD, de BOOSTFS lockbox en de opdracht "mount".


8. okt.  Poging set "boostfs" user credentials mislukt met de volgende fout :

bfs_krb5_err_handler: Kerberos error: -1765328360 [ERROR_MESSAGE=Kan initiële referenties niet ophalen.]

Kan Kerberos-referenties

niet instellen 1. Controleer of Active Directory-gebruikersreferenties correct zijn door u aan te melden bij de DC met Active Directory-gebruikersreferenties
2. Controleer of de tijd op de Linux-client en de Kerberos-server niet meer dan 5 minuten uit elkaar liggen. Kerberos-authenticatie vereist dat de kloktijden niet meer dan 5 minuten uit elkaar liggen.



9. okt. Bij het koppelen van de BOOSTFS in de Linux-client eindigt deze met de foutmelding "fusermount: mount failed: Operatie niet toegestaan."

Dit kan verschillende redenen hebben. "fusermount" is de onderliggende Linux-opdracht die uiteindelijk FUSE gebruikt om de DD BOOST-storage-eenheid lokaal in de naamruimte van de Linux-client te koppelen. Hiervoor zijn speciale bevoegdheden vereist. Dat is de reden waarom "fusermount" een SUID-binair bestand is in de Linux-client:

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

Omdat het een SUID-binair bestand is, betekent dit dat ongeacht de poging van de gebruiker om de storage-eenheid te koppelen, de "fusermount" wordt uitgevoerd met "root"-privileges. Als "fusermount" niet SUID is voor root, kan alleen de rootgebruiker van de Linux-client de externe BOOST-storage-eenheid koppelen. Dit hoeft geen probleem te zijn als je de mount instelt onder /etc/fstab, maar wel als de mount moet worden gedaan door een niet-rootgebruiker.


10. okt. BOOSTFS-koppelingen worden OK bevestigd, maar pogingen om toegang te krijgen tot de inhoud van de storage-eenheid op het koppelpunt mislukken met toestemmingsfouten

Bij het handmatig koppelen van de storage-eenheid met behulp van de DataDomain "boostfs"-opdracht of /etc/fstab (of zelfs "mount.fuse" vanuit de CLI), is het de onderliggende FUSE-implementatie van de standaard om alleen toegang tot bestanden toe te staan aan de Linux-client die de BOOSTFS heeft gekoppeld. Dus als de koppeling als root is gemaakt, heeft alleen root toegang tot de bestanden. Als de koppeling is gemaakt als gebruiker "postgres" (voor het maken van een back-up van een PostgreSQL DB), heeft alleen deze gebruiker de toestemming om toegang te krijgen tot de bestanden.

Als men om verschillende redenen andere gebruikers nodig heeft om toegang te krijgen tot de bestanden in de gekoppelde opslageenheid vanuit de Linux-cloud, moet de /etc/fuse.conf mogelijk worden afgesteld. Zie hier meer details:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Je zou de volgende optie moeten instellen in /etc/fuse.conf:

       user_allow_other
              Niet-rootgebruikers toestaan de allow_other of allow_root koppelingsopties op te geven (zie
              hieronder).
En gebruik vervolgens de volgende bij het monteren van de BOOST-opslageenheid, vanaf de opdrachtregel:
 

       allow_other
              Deze optie overschrijft de beveiligingsmaatregel die de bestandstoegang tot de gebruiker beperkt
              Mounten van het bestandssysteem.  Alle gebruikers (inclusief root) hebben dus toegang tot de bestanden.  Dit
              optie is standaard alleen toegestaan om te rooten, maar deze beperking kan worden verwijderd met
              De hierboven beschreven configuratieoptie (user_allow_other).

 

Vragen over BOOSTFS-configuratie:

1. Wat is het maximale aantal koppelpuntsecties dat men kan definiëren in het boostfs-configuratiebestand?
Er is geen limiet voor het aantal mounts in de mount point sectie van het boostfs.conf bestand. 

# Koppelpuntsecties worden gescheiden door [mountpoint] tags # # [/pad/naar/mount] # [/mnt/bofs] # Data Domain Hostnaam of IP-adres # data-domain-system=dd2500-1.yourdomain.com # Opslagruimte # storage-unit=su-name # Storage Unit Username # storage-unit-username=sysadmin # Subdirectory binnen de storage-unit om aan te koppelen # directory-name=path/to/subdir

2. Networker ondersteunt standaard BOOSTFS en kan overweg met on-the-fly mounts voor het uitvoeren van bepaalde taken en back-ups

Zelfs als Networker een back-upapplicatie met BOOST is, ondersteunt deze ook BOOSTFS op de Linux-clientsystemen waarop het is geïnstalleerd. Een voorbeeld van een NW-back-up die wordt gemaakt vanaf de opdrachtregel van de Linux-client, nadat de BOOSTFS-lockbox is ingesteld, is het volgende (PostgreSQL-back-up):

# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg 174908:(pid 16487):De back-updata opslaan in de pool 'DB'. 175019:(pid 16487):Ontvangst van de bindende informatie over het mediabeheer over de host-dd.example.com. 174910:(pid 16487):Verbonden met het nsrmmd-proces op de 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. De bestanden in de opslagset 'PostgreSQL_postgres_backuppostgre_full' op tijdstip '01/04/20 15:40:36' zijn: Grootte: Name: 2645 dump.sql 24000 postgresql.conf 2 bestand(en) 26645 bytes De back-upopdracht '/nsr/apps/config/scripts/backup-postgre-dbon1-full.sh' is voltooid. De back-up is voltooid.

Zodra de back-uptaak is geconfigureerd, kan deze ook worden gestart vanuit de NW GUI en daar de voortgang worden gecontroleerd.messages.engineering zou logboekvermeldingen weergeven zoals hieronder wanneer de koppeling die door NW is uitgegeven, is voltooid:

Apr 1 15:20:49 dd.example.com ddfs[17040]: LET OP: 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]: LET OP: ddboost-client.example.com-49808<>: Boostfs: Apr 1 15:22:52.395 16275 704915520 [I] BoostFS Version info: [BOOSTFS:7.0.0.0-633922 ZEKERING:2.9.7] Apr 1 15:20:49 dd.example.com ddfs[17040]: LET OP: ddboost-client.example.com-49808<>: Boostfs: Apr 1 15:22:52.395 16275 704915520 [I] bfs_lib_init: Montage dd.example.com:LSU_NAME op /mnt/mountpoint