Data Domain: Boostfsin asennus-, määritys- ja käyttöönotto-ongelmien vianmääritys

BOOSTFS on joihinkin käyttöjärjestelmiin mahdollisesti asennettava ohjelmistokomponentti, joka mahdollistaa BOOST-varmuuskopioinnin suorittamisen DataDomainissa käyttämättä mitään tiettyä varmuuskopiointisovellusta ja hyödyntää samalla joitakin BOOST-yhteensopivan varmuuskopiointisovelluksen ominaisuuksia, kuten Netbackup, Networker ja Avamar.

Lisätietoja asennuksesta ja käytöstä on Data Domainissa: DataDomain BOOST FS:n nopeutetut määritysvaiheet ja tiedot Tietämyskannan artikkeli.

Tämä tietämyskannan artikkeli sisältää kuitenkin joitakin tyypillisiä ongelmia, joita voi ilmetä BOOSTFS:ää määritettäessä ja käytettäessä, jotta asiakkailla olisi pikaopas tyypillisiin virheisiin, virhesanomiin ja tapa ratkaista ne. Tyypillisiä tällaisia virheitä ovat esimerkiksi "Boostfsia ei voida asentaa Linux-palvelimelle", "Boostfs-asennus epäonnistuu virheellä" tai "Varmuuskopiointi tai palautus epäonnistuu virheellä".

1. Vaadittu riippuvuus puuttuu BOOST FS -ohjelmiston

asennuksen yhteydessäJos toimitetun BOOSTFS-ohjelmiston RPM:n asentaminen asiakkaan Linux-käyttöjärjestelmään epäonnistuu, selvitä ensin, mitkä ovat BOOSTFS-ohjelmiston edellyttämät pakettiriippuvuudet:

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

Yllä olevassa esimerkissä paketti pyytää asentamaan FUSE (Filesystem in USEr space) -binäärit ja -kirjastot (BOOSTFS perustuu Linuxin FUSE:een) sekä minkä tahansa paketin, joka tarjoaa komentotulkin (sh) ja RPM:n oletuskirjastot. Siksi tämän BOOSTFS-paketin pitäisi asentua normaalisti Linux-järjestelmään, jossa "rpm" on suoritettu.


2. Ei voi asentaa /mnt/mountpoint/: odottamaton virhe

Kun yrität asentaa DD-etätallennusyksikköä paikallisesti Linux-asiakasohjelmaan BOOSTFS:n kautta, saatat saada yllä olevan virheen. Tarkista BOOSTFS-lokitiedosto Linux-asiakasohjelmassa. Esimerkiksi alla olevassa ensimmäisessä esimerkissä Lockbox-tiedosto ei sisällä isäntä-dd2500-abc.datadomain.com merkintää:

# vähemmän /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 29 03:45:25 22795 3267069888 [E] bfs_lockbox_get_user_info: Avainmerkintää dd2500-abc.datadomain.com:LSU2 ei löydy asetustiedostosta /opt/emc/boostfs/lockbox/boostfs.lockbox. Pyydettyä Lockbox-merkintää ei löytynyt. Jul 29 03:45:25 22795 3267069888 [E] bfs_conn_lookup: Yhteyden haku epäonnistui solmulle 0 tiedosto /.boostfs_sysinfo. (0 yhteyttä) Jul 29 03:45:25 22795 3267069888 [I] bfs_node_lookup: yhteyden muodostaminen tiedostolle /.boostfs_sysinfo epäonnistui Jul 29 03:45:25 22795 3267069888 [E] bfs_initialize_mntopts: Alustus epäonnistui

Ratkaisu tässä tapauksessa olisi lisätä avainlaatikkomerkintä DD-isäntään ja tallennusyksikköön, jotka asennetaan paikallisesti. Syntaksi olisi samanlainen kuin alla oleva esimerkki:

# /opt/emc/boostfs/bin/boostfs lockbox set -u sysadmin -d dd2500-abc.datadomain.com -s LSU2 Anna tallennuslaitteen käyttäjän salasana: Vahvista antamalla tallennuslaitteen käyttäjän salasana uudelleen: Avainlaatikon syöttösarja

Toinen mahdollinen virhe, joka näkyy paikallisissa BOOSTFS-asiakaslokeissa, on DD-isäntänimen puuttuminen asiakkaasta, esimerkiksi:

# vähemmän /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_open: Yhdistäminen epäonnistui (0 yhteyttä): 5037 Jul 29 04:05:50 22882 3322156992 [E] bfs_conn_lookup: Yhteyden haku epäonnistui solmulle 0 tiedosto /.boostfs_sysinfo. (0 yhteyttä) Jul 29 04:05:50 22882 3322156992 [I] bfs_node_lookup: Yhteyden muodostaminen tiedostolle /.boostfs_sysinfo epäonnistui Jul 29 04:05:50 22882 3322156992 [E] bfs_initialize_mntopts: Alustus epäonnistui

 
Ratkaisu tässä tapauksessa olisi joko lisätä staattinen hosntame IP-kartoitukseen Linux-asiakkaan /etc/host-tiedostoon tai konfiguroida kartoitus käytettävässä DNS-palvelimessa.


3. Kiinnityspiste /mnt/mountpoint ei ole tyhjä.
BoostFS:ää ei voi asentaa kiinnityspisteeseen, joka ei ole tyhjä. Yritä asentaa tyhjään kiinnityskohtaan.

Edellä oleva sanoma tarkoittaa, että määritettyä liityntäpistettä (/mnt/mountpoint) ei voi käyttää DD-etätallennusyksikön näyttämiseen, koska liityntäkohtaan ei voi olla aiemmin liitetty toista tiedostojärjestelmää eikä sillä voi olla mitään sisältöä. /mnt/mountpoint/:n on oltava tyhjä ja käyttämätön hakemisto Linux-asiakkaassa. Jos polulla on jo teline, sinun on määritettävä toinen liityntäkohta. Esimerkki:

# asenna /dev/mapper/vg00-lv_root päällä / tyyppi ext4 (rw) /dev/sda1 päällä /boot type ext4 (rw) BoostFS /mnt/mountpoint-tyyppisessä sulakkeessa.boostfs (rw,nosuid,nodev)

Tässä tapauksessa DD-etätallennusyksikkö on jo asennettu hakemistoon /mnt/mountpoint/, eikä sitä siksi voi asentaa uudelleen samaan hakemistoon.


4. DDBoostfs-kiinnike ripustetaan (paluu voi kestää jopa yli 10 minuuttia)

Näin voi käydä, kun Linux-työaseman ja DD-kohdelaitteen välinen palomuuri katkaisee liikennettä TCP-portteihin 111 ja 2049. Varmista, että Linux-asiakas saa DD-yhteyden TCP-portteihin 111 ja 2049, ja yritä sitten uudelleen, esimerkiksi:

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

Tämä on esimerkki siitä, mitä näet Linux-asiakkaiden BOOSTFS-lokeissa tällaisessa tapauksessa:

# vähemmän /opt/emc/boostfs/log/ddboostfs_0_0.log Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_open: Yhdistäminen epäonnistui (0 yhteyttä): 5037 Jul 27 06:34:53 32762 3724339136 [E] bfs_conn_lookup: Yhteyden haku epäonnistui solmulle 0 tiedosto /.boostfs_sysinfo. (0 yhteyttä) Jul 27 06:34:53 32762 3724339136 [I] bfs_node_lookup: yhteyden muodostaminen tiedostolle /.boostfs_sysinfo epäonnistui Jul 27 06:34:53 32762 3724339136 [E] bfs_initialize_mntopts: Alustus epäonnistui

5. Toiminta ei ole sallittua, kun liityntäkohdan alla olevaa sisältöä yritetään käyttää tai luetteloida

# ls -l /mnt/mountpoint/ LS: Lukuhakemisto .: Käyttö kielletty Yhteensä 0

Ongelma voi olla, että DD-etäportteihin 111 ja 2049 ei ole TCP-yhteyttä tai että lockbox-todennus on jotenkin vanhentunut. Varmista, että Linux-asiakas pystyy edelleen muodostamaan yhteyden DD:hen määritetyissä porteissa, ja yritä määrittää DD:n, tallennusyksikön ja BOOST-käyttäjän avainlaatikko uudelleen.


6. Riittämätöntä pääsyä tai tallennustilaa ei ole, kerberos-todennuksen avulla.

# boostfs-kiinnitys -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Riittämätön pääsy tai tallennusyksikkö LSU3:a ei ole

Kun avainruudussa käytetään Kerberos-todennusta, virheen todennäköisin syy on Kerberos-todennuslipun vanhentuminen. Tarkista mainittu lippu Linuxista, kuten alla:

# /opt/emc/boostfs/bin/boostfs kerberos query -s LSU3 -u käyttäjätunnus Asiakkaan päämies: username@DOMAIN.COM Kelvollinen aloitus: Ti Aug 23 11:02:49 2016 Päättyy: Ti Aug 23 21:01:07 2016 Uusi kunnes: Ti Aug 30 11:02:49 2016 Palvelun päänimi: krbtgt/DOMAIN. COM@DOMAIN.COM

Varmista DDR:ssä, että tallennusyksikköön määritetty BOOST-käyttäjä vastaa Linux-työaseman käyttäjää, kun asennat lukkolaatikkoa ja asennat BOOSTFS:ää (AD-käyttäjänimen ja tallennusyksikön käyttäjätunnuksen on oltava täsmälleen samat):

# ddboost tallennuslaitteen esitys Nimi Pre-Comp (GiB) Tila Käyttäjäraportti Fyysinen vuokraajayksikkö Koko (MiB) --------------- -------------- ------ -------- --------------- ----------- LSU3 0.0 RW käyttäjätunnus - - --------------- -------------- ------ -------- --------------- -----------

Varmista myös, että päivämäärä / kellonaika DD: ssä, Linux-asiakasohjelmassa ja Kerberos-palvelimessa (AD) on enintään 5 minuutin välein, tai lippujen kanssa voi ilmetä ongelmia, jotka ovat vanhentuneet epäjohdonmukaisen ajan vuoksi.

Alla on esimerkki siitä, mitä näkisimme DD-lokeissa, jos ajan ero olisi yli 5 minuuttia:

# lokikellon virheenkorjaus/ddfs.info 08/23 18:52:09.654 (tid 0x7f738141fb00): NFS3 hyväksytty 3000004b6 552 alkaen 10.64.229.125:55042 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:117 - tapahtuma gss_error, gss_accept_sec_context epäonnistui: maj=0xd0000, min=0x96c73a25 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:126 - tapahtuma gss_error, määrittelemätön GSS-vika. Alakoodi voi antaa lisätietoja 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_print_error:141 - tapahtuma gss_error, kello vinoutui liian suureksi 08/23 18:52:09.660 (tid 0x7f738140c890): [dd_rpc2_nfs x3000004b6] dd_rpc_gss_accept:217 - Tapahtuma gss_accept_failed, MAJ=851968, MIn2529638949 08/23 18:52:09.660 (tid 0x7f73814233f0): NFS3 tuhosi TCP 3000004b6

Ja nämä ovat BOOSTFS Linux -isäntälokeille:

# vähemmän /opt/emc/boostfs/log/ddboostfs_0_0.log Elo 23 18:04:39 1044 2019465280 [E] bfs_conn_open: Yhdistäminen epäonnistui (0 yhteyttä): 5075 Elokuu 23 18:04:39 1044 2019465280 [E] bfs_conn_lookup: yhteyden haku epäonnistui solmulle 0 tiedosto /.boostfs_sysinfo. (0 yhteyttä) Elokuu 23 18:04:39 1044 2019465280 [I] bfs_node_lookup: yhteyden muodostaminen tiedostolle /.boostfs_sysinfo epäonnistui Elokuu 23 18:04:39 1044 2019465280 [E] bfs_initialize_mntopts: alustus epäonnistui

7.  Boostfs-kiinnitys Kerberos-todennuksella epäonnistuu ja näyttöön tulee seuraava virhe: "Lockbox- tai lockbox-merkintää ei voi käyttää" 

# /opt/emc/boostfs/bin/boostfs-kiinnike -s LSU3 -d dd2500.domain.com /mnt/mountpoint/ Lockbox- tai Lockbox-merkintää ei voi käyttää ei löydy

 
Jos aiot käyttää BOOSTFS-määritysasetuksia tiedostossa "/opt/emc/boostfs/etc/boostfs.conf", tarkista tiedoston asetus [global] ja varmista, ettei sitä kommentoida (jotta jokin globaaleista vaihtoehdoista toimisi, avainsana "[global]" on jätettävä kommentoimatta). Tätä avainsanaa kommentoidaan oletuksena.

Esimerkki BOOSTFS:n "/opt/emc/boostfs/etc/boostfs.conf" -määritystiedoston sisällöstä:

# Kommentteja ei sallita vaihtoehdon arvoparin jälkeen. # ############################################################################# [maailmanlaajuinen] # Data Domain -isäntänimi tai IP-osoite # data-domain-system=dd2500.domain.com

Esimerkkitulos, joka näkyisi Linux-työaseman BOOSTFS-lokeissa:

# vähemmän /opt/emc/boostfs/log/ddboostfs_0_0.log Elokuu 24 08:23:35 27227 3565582272 [E] bfs_lockbox_get_user_info: Avainmerkintää dd2500-rtp2.techsupp.local:LSU3 ei löydy asetustiedostosta /opt/emc/boostfs/lockbox/boostfs.lockbox. Pyydettyä Lockbox-merkintää ei löytynyt. Elokuu 24 08:23:35 27227 3565582272 [E] bfs_conn_lookup: yhteyden haku epäonnistui solmulle 0 tiedosto /.boostfs_sysinfo. (0 yhteyttä) Elokuu 24 08:23:35 27227 3565582272 [I] bfs_node_lookup: yhteyden muodostaminen tiedostolle /.boostfs_sysinfo epäonnistui Elokuu 24 08:23:35 27227 3565582272 [E] bfs_initialize_mntopts: alustus epäonnistui

Virhe voi johtua myös siitä, että Linux-asiakkaan "mount"-komennossa käytetään eri isäntänimeä, tallennusyksikön nimeä tai BOOST-käyttäjänimeä verrattuna lockboxin asennukseen käytettyyn tai kohde-DD:tä vastaaviin isäntänimiin. Varmista, että kaikki nimet vastaavat DD:tä, BOOSTFS-avainlaatikkoa ja mount-komentoa.


8.  Boostfs-tunnistetietojen yritys epäonnistuu ja näyttää seuraavan virheen :

bfs_krb5_err_handler: Kerberos-virhe: -1765328360 [ERROR_MESSAGE=Ensimmäisten tunnistetietojen saaminen epäonnistui.]

Kerberos-tunnistetietoja

ei voi määrittää 1. Varmista, että Active Directory -käyttäjän tunnistetiedot ovat oikein, kirjautumalla toimialueelle Active Directory -käyttäjän tunnistetiedoilla
2. Varmista, että Linux-asiakkaan ja Kerberos-palvelimen välillä on enintään 5 minuuttia. Kerberos-todennus edellyttää, että kellonaikojen välillä on enintään 5 minuuttia.



9. Kun asennat BOOSTFS: n Linux-asiakkaaseen, se päättyy virheeseen "fusermount: mount failed: Toiminta ei ole sallittua."

Tämä voi johtua useista syistä. "fusermount" on taustalla oleva Linux-komento, joka lopulta käyttää FUSE:a DD BOOST -tallennusyksikön liittämiseen paikallisesti Linux-työaseman nimitilaan. Tämä edellyttää erityisiä etuoikeuksia. Siksi "fusermount" on SUID-binaari Linux-asiakkaassa:

# ls -l / usr / bin / fusermount -RWSR-XR-x. 1 juurijuuri 38680, 11. toukokuuta 2019 /usr/bin/fusermount

SUID-binaari tarkoittaa, että riippumatta siitä, mitä käyttäjä yrittää asentaa tallennusyksikköön, "fusermount" suoritetaan root-oikeuksilla. Jos "fusermount" ei ole SUID-pääkäyttäjä, vain Linux-asiakasohjelman root-käyttäjä voi ehkä ottaa käyttöön BOOST-etätallennusyksikön. Tämä ei ehkä ole ongelma määritettäessä kiinnitystä tiedostossa /etc/fstab, mutta näin on silloin, kun asennuksen tekee muu kuin root-käyttäjä.


10. BOOSTFS-kiinnikkeet OK, mutta yritykset käyttää tallennusyksikön sisältöä liityntäkohdassa epäonnistuvat ja johtuvat käyttöoikeusvirheistä

Kun tallennusyksikkö asennetaan manuaalisesti joko DataDomainin boostfs-komennolla tai /etc/fstab-komennolla (tai jopa komentorivikäyttöliittymän mount.fuse-komennolla), oletusarvon mukainen FUSE-toteutus sallii tiedostojen käytön vain sillä Linux-asiakasohjelmalla userid, johon BOOSTFS on asennettu. Jos asennus on tehty pääkäyttäjänä, vain pääkäyttäjä voi käyttää tiedostoja. Jos asennus on tehty käyttäjän postgres-muodossa (PostgreSQL DB:n varmuuskopiointia varten), vain tällä käyttäjällä on tiedostojen käyttöoikeus.

Jos eri syistä muiden käyttäjien on voitava käyttää asennetun tallennusyksikön tiedostoja Linux-pilvestä, /etc/fuse.conf on ehkä viritettävä. Katso lisätietoja täältä:
http://manpages.ubuntu.com/manpages/bionic/en/man8/mount.fuse.8.html

Seuraava asetus on määritettävä tiedostossa /etc/fuse.conf:

       user_allow_other
              Salli muiden kuin root-käyttäjien määrittää allow_other - tai allow_root-asennusvaihtoehdot (katso
              alla).
Käytä sitten seuraavaa asentaessasi BOOST-tallennusyksikköä komentoriviltä:
 

       allow_other
              Tämä vaihtoehto ohittaa suojaustoimenpiteen, joka rajoittaa tiedostojen käyttöä käyttäjälle
              tiedostojärjestelmän asentaminen.  Joten kaikki käyttäjät (mukaan lukien root) voivat käyttää tiedostoja.  Tämä
              Asetus on oletusarvoisesti sallittu vain juurtua, mutta tämä rajoitus voidaan poistaa
              edellä kuvattu määritysvaihtoehto (user_allow_other).

 

BOOSTFS-kokoonpanoon liittyvät kysymykset:

1. Mikä on suurin sallittu määrä liityntäkohtien osia, jotka voidaan määrittää boostfs-määritystiedostossa?
Boostfs.conf-tiedoston liityntäkohtaosassa ei ole kiinnikkeiden määrää rajoitettu. 

# Liityntäkohtien osat erotetaan toisistaan [mountpoint]-tunnisteilla # # [/polku/to/mount] # [/mnt/bofs] # Data Domain -isäntänimi tai IP-osoite # data-domain-system=dd2500-1.yourdomain.com # Tallennusyksikkö # tallennusyksikkö=su-nimi # Tallennusyksikön käyttäjänimi # storage-unit-username=sysadmin # Alihakemisto tallennusyksikössä, johon asennetaan # hakemisto-nimi=polku/to/subdir

2. Networker tukee oletusarvoisesti BOOSTFS:ää ja pystyy käsittelemään lennossa olevia kiinnikkeitä tiettyjen tehtävien ja varmuuskopioiden

suorittamiseenVaikka Networker on BOOST-yhteensopiva varmuuskopiointisovellus, se tukee BOOSTFS:ää myös niissä Linux-asiakasjärjestelmissä, joihin se on asennettu. Yksi esimerkki Linux-työaseman komentoriviltä otetusta NW-varmuuskopiosta, kun BOOSTFS-avainlaatikko on määritetty, olisi seuraava (PostgreSQL-varmuuskopiointi):

# nsroappbackup -z /nsr/apps/config/backup_postgresql.cfg 174908:(pid 16487):Varmuuskopiotietojen tallentaminen varantoon 'DB'. 175019:(pid 16487):Sain mediahallinnan sitovat tiedot isännästä 'dd.example.com'. 174910: (pid 16487):Yhdistetty nsrmmd-prosessiin isännässä 'dd.example.com'. + /usr/pgsql-11/bin/pg_dump --file=/nsr/apps/tmp/e3106c82_294324_16487/dump.sql --format=tavallinen Käsittelyä jatkettiin palautetulla arvolla 0. + /bin/cp /data/postgresql.conf /nsr/apps/tmp/e3106c82_294324_16487/ Käsittelyä jatkettiin palautetulla arvolla 0. Tallennussarjan 'PostgreSQL_postgres_backuppostgre_full' tiedostot hetkellä '01/04/20 15:40:36' ovat: Koko: Name: 2645 dump.sql 24000 postgresql.conf 2 tiedosto(a) 26645 tavua Varmuuskopiointikomento /nsr/apps/config/scripts/backup-postgre-dbon1-full.sh on valmis. Varmuuskopiointi on valmis.

Kun varmuuskopiointityö on määritetty, se voidaan myös käynnistää NW-käyttöliittymässä ja edistymistä voidaan seurata siellä.messages.engineering näyttää alla olevan kaltaiset lokimerkinnät, kun NW:n myöntämä asennus on tehty:

Huhti 1 15:20:49 dd.example.com ddfs[17040]: VAROITUS: ddboost-client.example.com-49808<>: Boostfit: Huhti 1 15:22:52.395 16275 704915520 [I] DDBoost-laajennuksen versio on: [7.0.0.0.633508] Huhti 1 15:20:49 dd.example.com ddfs[17040]: VAROITUS: ddboost-client.example.com-49808<>: Boostfit: Huhti 1 15:22:52.395 16275 704915520 [I] BoostFS-version tiedot: [BOOSTFS:7.0.0.0-633922 SULAKE:2.9.7] Huhti 1 15:20:49 dd.example.com ddfs[17040]: VAROITUS: ddboost-client.example.com-49808<>: Boostfit: Huhti 1 15:22:52.395 16275 704915520 [I] bfs_lib_init: Kiinnitys dd.example.com:LSU_NAME /mnt/mountpointiin