Unofficial

QNAP Speicherpool oder Volume nicht aktiv: Was Sie zuerst prüfen

Befehle über SSH, die nur lesen, zeigen, welche Schicht den Pool gestoppt hat: Laufwerke und RAID, LVM, die Metadaten des Thin-Pools oder das Dateisystem des Volumes.

Auf einem QNAP NAS mit QTS ist der Speicher in Schichten aufgebaut. Die Laufwerke bilden ein RAID, LVM legt darauf einen Thin-Pool an, und die Volumes liegen im Pool. Ein Pool oder ein Volume fällt aus, wenn eine dieser Schichten versagt.

Prüfen Sie die Schichten von den Laufwerken aufwärts, in der Reihenfolge unten. Jeder Schritt nennt die Befehle, die Bedeutung ihrer Ausgabe und die Schicht, auf die sie zeigt. Keiner der Befehle ändert das RAID, LVM oder den Pool.

QTS mit LVM-Thin-Pool · Befehle über SSH, als admin · geprüft mit LVM Pool Repair 1.8

Volume und Dateisystem ext4ext4ext4 Metadaten des Thin-Pools tp1_tmetatp1 LVM vg1 · PV Laufwerke und RAID md1
Vier Schichten, von den Laufwerken aufwärts

Bevor Sie etwas ändern

  • Ändern Sie nichts, solange Sie nicht wissen, welche Schicht versagt hat. Ziehen oder tauschen Sie keine Laufwerke. Starten Sie keine Reparatur in QTS oder über SSH, bevor Sie die Prüfungen unten gelesen haben.
  • Eine Reparatur des Speichers lässt sich oft nicht rückgängig machen. Bevor etwas in den Pool schreibt, sorgen Sie für ein Backup Ihrer wichtigen Daten.
  • Legen Sie Protokolle und Kopien außerhalb des geprüften Pools ab: auf einem externen Laufwerk oder auf einem Volume eines anderen Pools.
  • Keine Prüfung und keine Reparatur kann Ihnen Ihre Daten versprechen. Eine Reparatur beschädigter Mapping-Bereiche stellt die Daten in diesen Bereichen nicht wieder her.
  • Diese Seite gilt für QTS mit einem LVM-Thin-Pool. QuTS hero nutzt ZFS, dafür gelten weder diese Prüfungen noch LVM Pool Repair.

Vier Schichten, von den Laufwerken aufwärts

Eine Schicht funktioniert nur, wenn die Schicht darunter funktioniert. Deshalb beginnt die Prüfung bei den Laufwerken. LVM Pool Repair folgt derselben Regel: Es repariert den Speicher von unten nach oben und hält an, wenn eine tiefere Schicht schuld ist.

  1. Laufwerke und RAID

    QTS fasst Partitionen der Laufwerke zu md-RAID-Arrays zusammen. Ein Datenpool liegt auf so einem Array, zum Beispiel md1.

    cat /proc/mdstat
  2. LVM

    LVM nutzt jedes Array oder ein DRBD-Gerät darauf als physisches Volume (PV). Die PVs eines Pools bilden eine Volume-Gruppe (VG), zum Beispiel vg1.

    pvs · vgs
  3. Metadaten des Thin-Pools

    Der Thin-Pool, zum Beispiel tp1, hält seine Metadaten auf einem eigenen Gerät, tp1_tmeta. Die Metadaten bilden jeden Block jedes Volumes im Pool ab.

    lvs -a
  4. Volume und Dateisystem

    Jedes Volume ist ein Thin-Volume im Pool mit einem ext4-Dateisystem. QTS hängt es ein, und darauf liegen die freigegebenen Ordner.

    dmesg

Der Reihe nach prüfen

Melden Sie sich per SSH als admin am NAS an. Führen Sie die Befehle eines Schritts aus und lesen Sie die Ausgabe. Gehen Sie erst zum nächsten Schritt, wenn die Schicht in Ordnung aussieht.

  1. Das Kernel-Protokoll lesen

    Das Kernel-Protokoll zeigt Laufwerksfehler und die Meldungen der device-mapper-Geräte des Pools.

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

    E/A-Fehler der Laufwerke unter dem Pool zeigen auf ein Laufwerk. Testen Sie das Laufwerk, bevor Sie sich die Schichten darüber ansehen.

  2. Das RAID prüfen

    /proc/mdstat zeigt jedes md-Array mit seinem Zustand und seinen Mitgliedern. md_checker zeigt die Daten-Arrays mit dem Zustand jedes Laufwerks.

    cat /proc/mdstat
    md_checker

    Ein Array mit inactive bedeutet ein RAID-Problem. Bei [4/3] fehlt eines von 4 Mitgliedern, und das Array läuft degradiert. recovery, resync, reshape oder check heißt, dass das Array beschäftigt ist.

  3. LVM prüfen

    pvs zeigt die physischen Volumes, vgs die Volume-Gruppen und lvs -a den Pool mit seinen Volumes.

    pvs
    vgs
    lvs -a

    Ein m an dritter Stelle der Spalte Attr in pvs (a-m) heißt: LVM hat das physische Volume als fehlend markiert. Ein PV, das als unknown device erscheint, gibt es im System nicht. Zeigt lvs -a gar keinen Thin-Pool, liegt der Fehler unter den Metadaten, im RAID oder in LVM.

  4. Die Zeile des Pools in lvs -a lesen

    Die Spalte Attr des Pools beginnt mit t. Ihr neuntes Zeichen ist der Zustand, den LVM meldet:

    M
    die Metadaten sind schreibgeschützt
    F
    der Pool ist ausgefallen
    D
    im Pool ist kein Platz für Daten mehr
    p
    unvollständig: ein physisches Volume des Pools fehlt

    Die Spalte Attr eines Volumes beginnt mit V. Ein a an fünfter Stelle heißt aktiv.

    Hat LVM oder das Kernel-Protokoll eine dieser Meldungen ausgegeben, nennt die Meldung die Schicht:

    Refusing activation of partial LV
    ein physisches Volume fehlt: die LVM-Schicht
    transaction_id
    der Eintrag des Pools in LVM passt nicht zu den Metadaten des Pools: die LVM-Konfiguration
    Check of thin pool … failed
    die Metadaten des Pools
    too small for target
    das RAID-Array ist kleiner als die Volumes darauf: die RAID-Schicht
  5. Die Metadaten bei abgeschaltetem Pool prüfen

    Nur thin_check am abgeschalteten Pool liefert die Diagnose der Metadaten. Den Pool abzuschalten ist bereits eine Änderung, deshalb übernimmt das LVM Pool Repair: Schritt 2 schaltet den Pool ab, Schritt 1 führt die Prüfung aus. Bei einem Pool, der noch läuft, bietet Schritt 1 eine vorläufige Prüfung an, die nur liest.

    $ 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)
    Echte Reparaturen ansehen →
  6. Das Dateisystem eines Volumes prüfen, das sich nicht einhängen lässt

    Sind der Pool und seine Volumes in lvs -a aktiv, lässt sich ein Volume aber trotzdem nicht einhängen, sehen Sie sich sein Dateisystem an.

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

    Fehler von EXT4-fs zeigen auf das Dateisystem eines Volumes. Check File System in QTS prüft und repariert es. Starten Sie es erst, wenn Sie die Prüfungen oben gelesen haben.

Was ein Befund bedeutet

Jede Karte nennt, was Sie sehen, auf welche Schicht es zeigt und was LVM Pool Repair 1.8 in diesem Fall tut.

Laufwerke und RAID

  • inactive

    Ein md-Array unter dem Pool ist inaktiv. Das ist ein RAID-Problem.

    Das Skript beginnt keine Reparatur. Es verlangt, zuerst das RAID zu reparieren.

  • [4/3] [UUU_]

    Das Array läuft, aber ein Mitglied fehlt, oder ein Rebuild, Resync, Reshape oder Check läuft.

    Das Skript fragt, bevor es in den Pool schreibt, und die Vorgabe ist Nein. Lassen Sie einen laufenden Rebuild zuerst fertig werden.

  • I/O error

    Das Kernel-Protokoll meldet E/A-Fehler der Laufwerke unter dem Pool oder Speicherfehler.

    Das Skript fragt, bevor es schreibt, und die Vorgabe ist Nein. Testen Sie zuerst die Laufwerke mit DriveTime und den RAM mit MemHound.

LVM

  • a-m

    LVM hat ein physisches Volume des Pools als fehlend markiert oder zeigt es als unknown device. Die Aktivierung bricht ab mit Refusing activation of partial LV.

    Das Skript hält an: Das ist die LVM-Schicht, nicht die Metadaten des Pools. Bei einem unknown device verweist es zurück auf die RAID-Schicht.

  • No thin pool found

    lvs -a zeigt keinen Thin-Pool. Der Fehler liegt unter den Metadaten des Pools.

    Das Skript hält an und nennt die Befehle, die RAID und LVM nur lesen: cat /proc/mdstat, md_checker, mdadm -E /dev/sdX3, pvs, vgs, lvs -a.

Metadaten des Thin-Pools

  • SSD cache

    Der Pool hat einen SSD-Cache zum Lesen und Schreiben oder nur zum Schreiben, oder Qtier hält Daten in zwei oder mehr Stufen.

    Das Skript hält an, bevor es etwas ändert, und verweist auf den QNAP-Support. Bei einem SSD-Cache nur zum Lesen fragt es zuerst, ob der Cache entfernt oder für diesen Pool deaktiviert ist.

  • thin_check

    LVM meldet Check of thin pool … failed, oder thin_check findet Fehler in den Metadaten des Pools.

    Für diesen Fall ist LVM Pool Repair gemacht. Der nächste Abschnitt nennt die drei Arten von Schäden.

  • metadata consistent

    thin_check findet keine Fehler in den Metadaten.

    Ist nur das Flag needs_check gesetzt, löscht das Skript es: Mit diesem Flag startet der Pool mit schreibgeschützten Metadaten. Sonst liegt der Fehler über dem Pool, im Dateisystem, oder darunter, im RAID oder in LVM.

Wenn die Metadaten des Thin-Pools die Ursache sind

LVM Pool Repair ist ein Shell-Skript mit Menü. Über SSH repariert es die Metadaten eines QNAP-Thin-Pools unter QTS. Seine Diagnose teilt die Schäden in drei Arten, jede mit eigenem Reparaturweg.

  • space map counts only

    Die Fehler liegen nur in den Zählern der Space Map, die Mapping-Bäume sind intakt. Das Skript baut eine reparierte Kopie, prüft sie und schreibt sie nach einem getippten YES in den Pool.

  • damaged superblock

    Der primäre Superblock ist beschädigt, und gültige Sicherungskopien davon gibt es. Nach einem getippten YES stellt das Skript den Superblock aus der neuesten gültigen Kopie wieder her.

  • mapping tree errors

    Teile des Baums, der die Blöcke eines Volumes abbildet, sind beschädigt. Der Pool läuft für ein Test-Einhängen nur zum Lesen auf einer reparierten Kopie, und Sie prüfen Ihre Daten, bevor das Skript die Kopie schreibt. Die Blöcke der verworfenen Bereiche lesen sich danach leer.

Bevor eine Reparatur in die originalen Metadaten schreibt, sichert das Skript ein Abbild davon und prüft es gegen das Gerät. In einem Test mit 600 Dateien zu 4 MiB auf einem Volume mit beschädigten Mappings waren nach der Reparatur 534 Dateien intakt. 66 Dateien hatten Daten in den verworfenen Bereichen und waren verändert.

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