Unofficial

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.

QTS met een LVM thin pool · opdrachten via SSH als admin · gecontroleerd met LVM Pool Repair 1.8

Volume en bestandssysteem ext4ext4ext4 Metadata van de thin pool tp1_tmetatp1 LVM vg1 · PV Schijven en RAID md1
Vier lagen, te beginnen bij de schijven

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.

  1. Schijven en RAID

    QTS voegt schijfpartities samen tot md RAID-arrays. Een datapool gebruikt zo’n array, bijvoorbeeld md1.

    cat /proc/mdstat
  2. 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 vg1.

    pvs · vgs
  3. Metadata van de thin pool

    De thin pool, bijvoorbeeld tp1, bewaart zijn metadata op een eigen apparaat, tp1_tmeta. De metadata leggen de mapping vast van elk blok van elk volume in de pool.

    lvs -a
  4. 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.

  1. 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.

  2. Controleer de RAID

    /proc/mdstat toont elke md-array met de status en de leden. md_checker toont de data-arrays met de status van elke schijf.

    cat /proc/mdstat
    md_checker

    Een array met de status inactive wijst op een RAID-probleem. Bij [4/3] ontbreekt één van de 4 leden en werkt de array in gedegradeerde modus. Bij recovery, resync, reshape of check is de array bezig.

  3. Controleer LVM

    pvs toont de fysieke volumes, vgs de volumegroepen en lvs -a de pool en de volumes daarin.

    pvs
    vgs
    lvs -a

    In pvs betekent een m op de derde positie in Attr (a-m) dat LVM het fysieke volume als ontbrekend markeert. Een PV met de aanduiding unknown device bestaat niet op het systeem. Als lvs -a geen thin pool toont, zit de fout onder de metadata, in de RAID of in LVM.

  4. 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. Een a op 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
  5. Stel de diagnose van de metadata met de pool offline

    Alleen thin_check op 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 →
  6. Controleer het bestandssysteem van een volume dat niet kan worden aangekoppeld

    Als lvs -a aangeeft 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-fs wijzen 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 melding Refusing 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 device verwijst het script naar de RAID-laag.

  • No thin pool found

    lvs -a toont 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 … failed of thin_check vindt 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_check vindt geen fouten in de metadata.

    Als alleen de vlag needs_check is 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 YES hebt getypt.

  • damaged superblock

    Het primaire superblok is beschadigd en er zijn geldige reservekopieën. Nadat je YES hebt 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.

Voordat een herstelactie naar de oorspronkelijke metadata schrijft, bewaart het script er een image van en verifieert de image aan de hand van het apparaat. Bij een test met 600 bestanden van 4 MiB op een volume met beschadigde mappings blijven 534 bestanden na herstel intact. De 66 bestanden met gegevens in de verwijderde bereiken veranderen.

=== QNAP pool repair 1.7 | TBS-h574TX | kernel 6.6.129-qnap | NAS-DEMO =======
 Pool: vg1/tp1   metadata: tp1_tmeta (65536 MiB)   scratch LV: lv544
 RAID: md1 raid1 [2/2] OK
 Work directory: /share/external/DEV3302_1/pool-recovery-..-tp1-20261120-132957
 Diagnosis: -   Tool: (detected at diagnosis)
 Stage: start   Path: -
 Steps: 1 Diag -- | 2 Offline next | 3 Backup -- | 4 Repair -- | 5 Start --
------------------------------------------------------------------------------
 [Enter] recommended step: 2) Offline
  a) Automatic run: the remaining steps; stops for decisions and before a write
  1) Status and diagnosis (thin_check, read-only)
  2) Prepare: stop the services, unmount, deactivate the VG
  3) Backup: LVM configuration + metadata image
  4) Repair the metadata
  5) Bring the pool and the volumes up
  6) Tools (tp_collect, undo the LVM swap, restore the backup...)
  7) Logs and history (command history, pager, before/after diff, report)