Unofficial

Lagringspool eller volym på en QNAP NAS är inte aktiv. Vad kontrollerar du först?

Med skrivskyddade kontroller via SSH ser du vilket lager som får poolen att stanna. Felet kan finnas i diskarna och RAID, i LVM, i den tunna poolens metadata eller i volymens filsystem.

På en QNAP NAS med QTS består lagringen av flera lager. Diskarna bildar en RAID-matris. LVM lägger en tunn pool på matrisen. Poolen innehåller volymerna. Ett fel i något av lagren får poolen eller en volym att stanna.

Kontrollera lagren i ordningen nedan, med diskarna först. Varje steg visar kommandona, vad deras utdata betyder och vilket lager resultatet pekar på. Inget av kommandona ändrar RAID, LVM eller poolen.

QTS med en tunn LVM-pool · kommandon via SSH som admin · kontrollerat mot LVM Pool Repair 1.8

Volym och filsystem ext4ext4ext4 Den tunna poolens metadata tp1_tmetatp1 LVM vg1 · PV Diskar och RAID md1
Fyra lager med diskarna längst ner

Innan du ändrar något

  • Ändra inget förrän du vet vilket lager som har fel. Ta inte ut eller byt några diskar. Läs kontrollerna nedan innan du startar en reparation i QTS eller via SSH.
  • En reparation av lagringen kan vara oåterkallelig. Se till att du har en säkerhetskopia av dina viktiga data innan något skriver till poolen.
  • Spara loggar och kopior utanför poolen du kontrollerar, på en extern disk eller en volym i en annan pool.
  • Ingen kontroll eller reparation kan garantera att du får tillbaka dina data. En reparation av skadade mappningsintervall kan inte återställa de data som fanns i dem.
  • Den här sidan gäller QTS med en tunn LVM-pool. QuTS hero använder ZFS. Kontrollerna och LVM Pool Repair gäller inte där.

Fyra lager med diskarna längst ner

Ett lager fungerar bara när lagret under fungerar. Börja därför kontrollerna med diskarna. LVM Pool Repair reparerar också lagringen nerifrån och upp och stannar om felet finns i ett lägre lager.

  1. Diskar och RAID

    QTS sammanför diskpartitionerna till md-baserade RAID-matriser. En datapool ligger på en sådan matris, till exempel md1.

    cat /proc/mdstat
  2. LVM

    LVM använder varje matris, eller en DRBD-enhet ovanpå den, som en fysisk volym (PV). Poolens fysiska volymer (PV) bildar en volymgrupp (VG), till exempel vg1.

    pvs · vgs
  3. Den tunna poolens metadata

    Den tunna poolen, till exempel tp1, lagrar sina metadata på en egen enhet, tp1_tmeta. Metadata mappar varje block i varje volym i poolen.

    lvs -a
  4. Volym och filsystem

    Varje volym i poolen är en tunn volym med ett ext4-filsystem. QTS monterar volymen. Den innehåller de delade mapparna.

    dmesg

Kontrollera i den här ordningen

Logga in på NAS-enheten via SSH som admin. Kör kommandona för steget och läs deras utdata. Gå vidare först när lagret verkar fungera som det ska.

  1. Läs kärnloggen

    Kärnloggen visar diskfel och meddelanden från poolens device-mapper-enheter.

    dmesg | grep -iE 'device-mapper|thin|I/O error' | tail -n 12

    I/O-fel på diskarna under poolen tyder på ett diskproblem. Testa disken innan du kontrollerar lagren ovanför.

  2. Kontrollera RAID

    /proc/mdstat listar varje md-matris med status och medlemmar. md_checker listar datamatriserna med status för varje disk.

    cat /proc/mdstat
    md_checker

    En matris märkt inactive visar på ett RAID-problem. Vid [4/3] saknas en av 4 medlemmar och matrisen körs i degraderat läge. recovery, resync, reshape eller check betyder att matrisen är upptagen.

  3. Kontrollera LVM

    pvs listar de fysiska volymerna, vgs volymgrupperna och lvs -a poolen och dess volymer.

    pvs
    vgs
    lvs -a

    I pvs betyder ett m på tredje plats i Attr (a-m) att LVM markerar den fysiska volymen som saknad. En fysisk volym (PV) som visas som unknown device finns inte i systemet. Om lvs -a inte visar någon tunn pool ligger felet under metadata, i RAID eller LVM.

  4. Läs poolens rad i lvs -a

    Poolens Attr börjar med t. Det nionde tecknet visar den status som LVM rapporterar.

    M
    metadata är skrivskyddade
    F
    poolen fungerar inte längre
    D
    poolens datautrymme är slut
    p
    partiell status, en fysisk volym i poolen saknas

    Volymens Attr börjar med V. Ett a på femte plats betyder att volymen är aktiv.

    Om LVM eller kärnloggen visar något av följande meddelanden, anger meddelandet vilket lager det gäller.

    Refusing activation of partial LV
    en fysisk volym saknas, felet finns i LVM-lagret
    transaction_id
    LVM:s uppgifter om poolen stämmer inte med poolens metadata, felet finns i LVM-konfigurationen
    Check of thin pool … failed
    poolens metadata
    too small for target
    RAID-matrisen är mindre än volymerna på den, felet finns i RAID-lagret
  5. Diagnostisera metadata när poolen är offline

    Bara thin_check på en pool som är offline ger en diagnos av dess metadata. Att ta poolen offline innebär en ändring och är därför ett steg i LVM Pool Repair. Steg 2 tar poolen offline och steg 1 kör kontrollen. Om poolen fortfarande är aktiv erbjuder steg 1 en preliminär skrivskyddad kontroll.

    $ 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)
    Se verkliga reparationer →
  6. Kontrollera filsystemet på en volym som inte går att montera

    Om lvs -a visar att poolen och dess volymer är aktiva, men en volym ändå inte går att montera, kontrollerar du volymens filsystem.

    dmesg | grep -iE 'EXT4-fs (error|warning)'

    Fel från EXT4-fs pekar på filsystemet på en volym. Check File System i QTS kontrollerar och reparerar det. Starta funktionen först när du har läst kontrollerna ovan.

Vad resultatet betyder

Varje kort visar vad du ser, vilket lager det pekar på och vad LVM Pool Repair 1.8 gör i det fallet.

Diskar och RAID

  • inactive

    En md-matris under poolen är inaktiv. Felet ligger i RAID.

    Skriptet startar ingen reparation. Det säger åt dig att reparera RAID först.

  • [4/3] [UUU_]

    Matrisen fungerar, men en medlem saknas eller så pågår en återuppbyggnad, omsynkronisering, omkonfigurering eller kontroll.

    Skriptet ber om bekräftelse innan det skriver till poolen. Standardsvaret är nej. Låt en pågående återuppbyggnad bli klar först.

  • I/O error

    Kärnloggen rapporterar I/O-fel på diskar under poolen eller minnesfel.

    Skriptet ber om bekräftelse innan det skriver. Standardsvaret är nej. Testa först diskarna med DriveTime och RAM-minnet med MemHound.

LVM

  • a-m

    LVM markerar en fysisk volym i poolen som saknad eller visar den som unknown device. Aktiveringen avbryts med meddelandet Refusing activation of partial LV.

    Skriptet stannar. Felet finns i LVM-lagret och poolens metadata är inte orsaken. Vid unknown device hänvisar skriptet till RAID-lagret.

  • No thin pool found

    lvs -a visar ingen tunn pool. Felet finns under poolens metadata.

    Skriptet stannar och anger de skrivskyddade kontrollerna för RAID och LVM. Kommandona är cat /proc/mdstat, md_checker, mdadm -E /dev/sdX3, pvs, vgs, lvs -a.

Den tunna poolens metadata

  • SSD cache

    Poolen använder en SSD-cache för läsning och skrivning eller enbart skrivning, eller så lagrar Qtier data på två eller flera lagringsnivåer.

    Skriptet stannar före varje ändring och hänvisar till QNAP-supporten. Om SSD-cachen är skrivskyddad frågar det först om cachen är borttagen eller inaktiverad för den här poolen.

  • thin_check

    LVM rapporterar Check of thin pool … failed eller så hittar thin_check fel i poolens metadata.

    LVM Pool Repair är gjort för det här fallet. Nästa avsnitt beskriver de tre typerna av skador.

  • metadata consistent

    thin_check hittar inga fel i metadata.

    Om bara flaggan needs_check är satt tar skriptet bort den. Med flaggan satt startar poolen med skrivskyddade metadata. Annars finns felet ovanför poolen, i filsystemet, eller under poolen, i RAID eller LVM.

När den tunna poolens metadata är orsaken

LVM Pool Repair är ett skalskript med en meny. Via SSH reparerar det metadata för en tunn pool på en QNAP med QTS. Diagnosen skiljer mellan tre typer av skador, var och en med en egen reparationsmetod.

  • space map counts only

    Bara räknarna i utrymmeskartan innehåller fel. Mappningsträden är intakta. Skriptet bygger en reparerad kopia, kontrollerar den och skriver den till poolen när du har skrivit YES.

  • damaged superblock

    Det primära superblocket är skadat och det finns giltiga säkerhetskopior av det. När du har skrivit YES återställer skriptet superblocket från den senaste giltiga kopian.

  • mapping tree errors

    Delar av trädet som mappar blocken i en volym är skadade. Poolen använder en reparerad kopia för en skrivskyddad testmontering. Kontrollera dina data innan skriptet skriver kopian. Därefter läses blocken i de borttagna intervallen som tomma.

Innan en reparation skriver till de ursprungliga metadata sparar skriptet en avbild och verifierar den mot enheten. I ett test med 600 filer på 4 MiB på en volym med skadade mappningar är 534 filer intakta efter reparationen. De 66 filer som har data i de borttagna intervallen ändras.

=== 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)