Wat controleer je eerst als een opslagpool of volume op een QNAP NAS niet actief is?
Met alleen-lezencontroles via SSH bepaal je in welke laag de pool vastloopt. De oorzaak kan liggen bij de schijven en de RAID, LVM, de metadata van de thin pool of het bestandssysteem van het volume.
Op een QNAP NAS met QTS bestaat de opslag uit lagen. De schijven vormen een RAID-array. LVM plaatst een thin pool op de array. De pool bevat de volumes. Als een van deze lagen uitvalt, stopt de pool of een volume.
Controleer de lagen in de onderstaande volgorde, te beginnen bij de schijven. Elke stap geeft de opdrachten, de betekenis van de uitvoer en de laag waarop de uitvoer wijst. Geen van de opdrachten wijzigt de RAID, LVM of de pool.
Voordat je iets wijzigt
- Wijzig niets totdat je weet welke laag uitvalt. Verwijder of vervang geen schijven. Lees de controles hieronder voordat je in QTS of via SSH een herstel start.
- Een opslagherstel kan onomkeerbaar zijn. Zorg voor een back-up van je belangrijke gegevens voordat er iets naar de pool schrijft.
- Bewaar logboeken en kopieën buiten de pool die je controleert, op een externe schijf of op een volume in een andere pool.
- Geen enkele controle of herstelactie garandeert dat je je gegevens terugkrijgt. Met herstel van beschadigde mappingbereiken krijg je de gegevens daarin niet terug.
- Deze pagina geldt voor QTS met een LVM thin pool. QuTS hero gebruikt ZFS. Deze controles en LVM Pool Repair zijn daarop niet van toepassing.
Vier lagen, te beginnen bij de schijven
Een laag werkt alleen als de laag eronder werkt. Begin de controles daarom bij de schijven. LVM Pool Repair begint ook bij de onderste lagen en stopt als een lagere laag het probleem veroorzaakt.
Schijven en RAID
QTS voegt schijfpartities samen tot md RAID-arrays. Een datapool gebruikt zo’n array, bijvoorbeeld
cat /proc/mdstatmd1.LVM
LVM gebruikt elke array, of een DRBD-apparaat daarop, als fysiek volume (PV). De PV’s van een pool vormen een volumegroep (VG), bijvoorbeeld
pvs · vgsvg1.Metadata van de thin pool
De thin pool, bijvoorbeeld
lvs -atp1, bewaart zijn metadata op een eigen apparaat,tp1_tmeta. De metadata leggen de mapping vast van elk blok van elk volume in de pool.Volume en bestandssysteem
Elk volume in de pool is een thin volume met een ext4-bestandssysteem. QTS koppelt het volume aan. Het volume bevat de gedeelde mappen.
dmesg
Controleer in deze volgorde
Meld je via SSH aan bij de NAS als admin. Voer de opdrachten van de stap uit en lees de uitvoer. Ga pas naar de volgende stap als de laag goed lijkt te werken.
Lees het kernellogboek
Het kernellogboek toont schijffouten en meldingen van de device-mapper-apparaten van de pool.
dmesg | grep -iE 'device-mapper|thin|I/O error' | tail -n 12
I/O-fouten op de schijven onder de pool wijzen op een schijfprobleem. Test de schijf voordat je de bovenliggende lagen controleert.
Controleer de RAID
/proc/mdstattoont elke md-array met de status en de leden.md_checkertoont de data-arrays met de status van elke schijf.cat /proc/mdstat md_checker
Een array met de status
inactivewijst op een RAID-probleem. Bij[4/3]ontbreekt één van de 4 leden en werkt de array in gedegradeerde modus. Bijrecovery,resync,reshapeofcheckis de array bezig.Controleer LVM
pvstoont de fysieke volumes,vgsde volumegroepen enlvs -ade pool en de volumes daarin.pvs vgs lvs -a
In
pvsbetekent eenmop de derde positie in Attr (a-m) dat LVM het fysieke volume als ontbrekend markeert. Een PV met de aanduidingunknown devicebestaat niet op het systeem. Alslvs -ageen thin pool toont, zit de fout onder de metadata, in de RAID of in LVM.Lees de regel van de pool in lvs -a
Het veld Attr van de pool begint met
t. Het negende teken geeft de status aan die LVM meldt.M- de metadata zijn alleen-lezen
F- de pool werkt niet meer
D- de pool heeft geen ruimte meer voor gegevens
p- gedeeltelijke status doordat een fysiek volume van de pool ontbreekt
Het veld Attr van een volume begint met
V. Eenaop de vijfde positie betekent dat het volume actief is.Als LVM of het kernellogboek een van deze meldingen toont, geeft de melding aan om welke laag het gaat.
Refusing activation of partial LV- er ontbreekt een fysiek volume in de LVM-laag
transaction_id- de poolgegevens in LVM komen niet overeen met de metadata van de pool, wat wijst op de LVM-configuratie
Check of thin pool … failed- de metadata van de pool
too small for target- de RAID-array is kleiner dan de volumes erop, wat wijst op de RAID-laag
Stel de diagnose van de metadata met de pool offline
Alleen
thin_checkop de offline pool geeft een diagnose van de metadata. De pool offline halen wijzigt de pool en is daarom een stap in LVM Pool Repair. Stap 2 haalt de pool offline en stap 1 voert de controle uit. Als de pool nog actief is, biedt stap 1 een voorlopige alleen-lezencontrole.$ pdata_tools_8192 thin_check /dev/mapper/vg1-tp1_tmeta examining superblock examining superblock backups 99 valid superblock backups, last backup_id=98 blocknr=8388509 examining devices tree examining mapping tree thin device 9 is missing mappings [1470, 1725] bad checksum in btree node (block 21996) thin device 9 is missing mappings [3285, 3540] bad checksum in btree node (block 22007) thin device 9 has unexpected number of mapped blocks expected 5730 != actual 5220 examining clone tree examining tiering tree examining tiering space maps -> exit code 1 (in: do_diag > thin_check_run)
Bekijk echte herstelacties → Controleer het bestandssysteem van een volume dat niet kan worden aangekoppeld
Als
lvs -aaangeeft dat de pool en zijn volumes actief zijn maar een volume nog steeds niet kan worden aangekoppeld, controleer dan het bestandssysteem ervan.dmesg | grep -iE 'EXT4-fs (error|warning)'
Fouten van
EXT4-fswijzen op het bestandssysteem van een volume. Check File System in QTS controleert en herstelt het. Start die functie pas als je de bovenstaande controles hebt gelezen.
Wat een bevinding betekent
Elke kaart toont wat je ziet, op welke laag het wijst en wat LVM Pool Repair 1.8 in dat geval doet.
Schijven en RAID
- inactive
Een md-array onder de pool is inactief. Het probleem zit in de RAID.
Het script start geen herstel. Het geeft aan dat je eerst de RAID moet herstellen.
- [4/3] [UUU_]
De array werkt, maar er ontbreekt een lid of er loopt een heropbouw, hersynchronisatie, herconfiguratie of controle.
Het script vraagt om bevestiging voordat het naar de pool schrijft. Het standaardantwoord is nee. Laat een lopende heropbouw eerst afronden.
- I/O error
Het kernellogboek meldt I/O-fouten op schijven onder de pool of geheugenfouten.
Het script vraagt om bevestiging voordat het schrijft. Het standaardantwoord is nee. Test eerst de schijven met DriveTime en het RAM met MemHound.
LVM
- a-m
LVM markeert een fysiek volume van de pool als ontbrekend of toont het als
unknown device. De activering stopt met de meldingRefusing activation of partial LV.Het script stopt. De fout zit in de LVM-laag en de metadata van de pool zijn niet de oorzaak. Bij
unknown deviceverwijst het script naar de RAID-laag. - No thin pool found
lvs -atoont geen thin pool. De fout zit onder de metadata van de pool.Het script stopt en geeft de alleen-lezencontroles voor RAID en LVM. Gebruik daarvoor
cat /proc/mdstat,md_checker,mdadm -E /dev/sdX3,pvs,vgs,lvs -a.
Metadata van de thin pool
- SSD cache
De pool gebruikt een SSD-cache voor lezen en schrijven of alleen voor schrijven, of Qtier bewaart gegevens in twee of meer opslaglagen.
Het script stopt voordat het iets wijzigt en verwijst je naar QNAP-ondersteuning. Bij een alleen-lezen SSD-cache vraagt het eerst of de cache is verwijderd of voor deze pool is uitgeschakeld.
- thin_check
LVM meldt
Check of thin pool … failedofthin_checkvindt fouten in de metadata van de pool.LVM Pool Repair is voor dit geval bedoeld. De volgende sectie beschrijft de drie soorten schade.
- metadata consistent
thin_checkvindt geen fouten in de metadata.Als alleen de vlag
needs_checkis ingesteld, wist het script die. Met die vlag start de pool met alleen-lezenmetadata. Anders zit de fout boven de pool, in het bestandssysteem, of eronder, in de RAID of in LVM.
Wanneer het probleem in de metadata van de thin pool zit
LVM Pool Repair is een shellscript met een menu. Via SSH herstelt het de metadata van een QNAP thin pool op QTS. De diagnose onderscheidt drie soorten schade, elk met een eigen herstelprocedure.
- space map counts only
Alleen de tellers in de ruimtekaart bevatten fouten. De mappingbomen zijn intact. Het script maakt een herstelde kopie, controleert die en schrijft die naar de pool nadat je
YEShebt getypt. - damaged superblock
Het primaire superblok is beschadigd en er zijn geldige reservekopieën. Nadat je
YEShebt getypt, herstelt het script het superblok met de nieuwste geldige kopie. - mapping tree errors
Delen van de boom die de blokken van een volume in kaart brengt, zijn beschadigd. De pool gebruikt een herstelde kopie om het volume als test in alleen-lezenmodus aan te koppelen. Controleer je gegevens voordat het script de kopie wegschrijft. Daarna geven blokken in de verwijderde bereiken bij het lezen lege gegevens terug.