Unofficial

Que vérifier en premier si un pool de stockage ou un volume QNAP est inactif ?

Les vérifications en lecture seule via SSH identifient la couche qui bloque le pool. Le problème peut venir des disques et du RAID, de LVM, des métadonnées du thin pool ou du système de fichiers du volume.

Sur un NAS QNAP sous QTS, le stockage comporte plusieurs couches. Les disques forment un ensemble RAID. LVM place un thin pool sur cet ensemble. Le pool contient les volumes. Une défaillance de l’une de ces couches arrête le pool ou un volume.

Vérifiez les couches dans l’ordre ci-dessous, en commençant par les disques. Chaque étape indique les commandes, la signification de leur sortie et la couche concernée. Aucune commande ne modifie le RAID, LVM ni le pool.

QTS avec un thin pool LVM · commandes via SSH en tant qu’admin · vérifié avec LVM Pool Repair 1.8

Volume et système de fichiers ext4ext4ext4 Métadonnées du thin pool tp1_tmetatp1 LVM vg1 · PV Disques et RAID md1
Quatre couches à vérifier en commençant par les disques

Avant toute modification

  • Ne modifiez rien avant d’avoir identifié la couche défaillante. Ne retirez ni ne remplacez de disque. Lisez les vérifications ci-dessous avant de lancer une réparation dans QTS ou via SSH.
  • Une réparation du stockage peut être irréversible. Avant toute écriture dans le pool, vérifiez que vous disposez d’une sauvegarde de vos données importantes.
  • Conservez les journaux et les copies hors du pool que vous vérifiez, sur un disque externe ou sur un volume d’un autre pool.
  • Aucune vérification ni réparation ne garantit la récupération de vos données. Réparer des plages de mappage endommagées ne récupère pas les données qu’elles contenaient.
  • Cette page concerne QTS avec un thin pool LVM. QuTS hero utilise ZFS. Ces vérifications et LVM Pool Repair ne s’y appliquent pas.

Quatre couches à vérifier en commençant par les disques

Chaque couche dépend du bon fonctionnement de celle qui se trouve en dessous. Commencez donc par les disques. LVM Pool Repair répare aussi le stockage en commençant par les couches inférieures et s’arrête si l’une d’elles est en cause.

  1. Disques et RAID

    QTS regroupe les partitions des disques en ensembles RAID de type md. Un pool de données s’appuie sur un tel ensemble, par exemple md1.

    cat /proc/mdstat
  2. LVM

    LVM utilise chaque ensemble, ou un périphérique DRBD placé dessus, comme volume physique (PV). Les PV d’un pool forment un groupe de volumes (VG), par exemple vg1.

    pvs · vgs
  3. Métadonnées du thin pool

    Le thin pool, par exemple tp1, stocke ses métadonnées sur un périphérique dédié, tp1_tmeta. Ces métadonnées établissent la correspondance pour chaque bloc de chaque volume du pool.

    lvs -a
  4. Volume et système de fichiers

    Chaque volume du pool est un volume léger doté d’un système de fichiers ext4. QTS le monte. Il contient les dossiers partagés.

    dmesg

Vérifier dans cet ordre

Connectez-vous au NAS via SSH avec le compte admin. Exécutez les commandes de l’étape et lisez leur sortie. Passez à l’étape suivante seulement si la couche semble fonctionner correctement.

  1. Lire le journal du noyau

    Le journal du noyau affiche les erreurs de disque et les messages des périphériques device-mapper du pool.

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

    Les erreurs d’E/S sur les disques du pool indiquent un problème de disque. Testez le disque avant d’examiner les couches supérieures.

  2. Vérifier le RAID

    /proc/mdstat liste chaque ensemble md avec son état et ses membres. md_checker liste les ensembles de données avec l’état de chaque disque.

    cat /proc/mdstat
    md_checker

    Un ensemble marqué inactive indique un problème de RAID. Avec [4/3], un membre sur 4 manque et l’ensemble fonctionne en mode dégradé. La présence de recovery, resync, reshape ou check indique une opération en cours sur l’ensemble.

  3. Vérifier LVM

    pvs liste les volumes physiques, vgs les groupes de volumes et lvs -a le pool et ses volumes.

    pvs
    vgs
    lvs -a

    Dans pvs, un m en troisième position dans Attr (a-m) signifie que LVM marque le volume physique comme manquant. Un PV affiché comme unknown device n’existe pas sur le système. Si lvs -a n’affiche aucun thin pool, le problème se situe sous les métadonnées, dans le RAID ou dans LVM.

  4. Lire la ligne du pool dans lvs -a

    Le champ Attr du pool commence par t. Son neuvième caractère indique l’état de santé signalé par LVM.

    M
    les métadonnées sont en lecture seule
    F
    le pool est en panne
    D
    le pool n’a plus d’espace pour les données
    p
    état partiel, il manque un volume physique du pool

    Le champ Attr d’un volume commence par V. Un a en cinquième position indique que le volume est actif.

    Si LVM affiche l’un de ces messages ou si le journal du noyau le contient, le message indique la couche en cause.

    Refusing activation of partial LV
    il manque un volume physique, la couche LVM est en cause
    transaction_id
    les informations sur le pool dans LVM ne correspondent pas à ses métadonnées, la configuration de LVM est en cause
    Check of thin pool … failed
    métadonnées du pool
    too small for target
    l’ensemble RAID est plus petit que les volumes qu’il contient, la couche RAID est en cause
  5. Diagnostiquer les métadonnées du pool hors ligne

    Seul thin_check exécuté sur le pool hors ligne permet de diagnostiquer les métadonnées. La mise hors ligne modifie le pool et fait donc partie de LVM Pool Repair. L’étape 2 met le pool hors ligne et l’étape 1 lance la vérification. Sur un pool encore actif, l’étape 1 propose une vérification préliminaire en lecture seule.

    $ 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)
    Voir des réparations réelles →
  6. Vérifier le système de fichiers d’un volume qui ne se monte pas

    Si lvs -a indique que le pool et ses volumes sont actifs mais qu’un volume ne se monte toujours pas, examinez son système de fichiers.

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

    Les erreurs EXT4-fs indiquent un problème dans le système de fichiers d’un volume. Dans QTS, Check File System le vérifie et le répare. Lancez cette fonction seulement après avoir lu les vérifications ci-dessus.

Interpréter un résultat

Chaque fiche indique le résultat observé, la couche concernée et ce que fait LVM Pool Repair 1.8 dans ce cas.

Disques et RAID

  • inactive

    Un ensemble md sous le pool est inactif. Le problème concerne le RAID.

    Le script ne lance aucune réparation. Il vous demande de réparer le RAID en premier.

  • [4/3] [UUU_]

    L’ensemble fonctionne, mais il manque un membre ou une reconstruction, une resynchronisation, une reconfiguration ou une vérification est en cours.

    Le script demande votre accord avant d’écrire dans le pool. La réponse par défaut est non. Si une reconstruction est en cours, attendez qu’elle se termine.

  • I/O error

    Le journal du noyau signale des erreurs d’E/S sur les disques du pool ou des erreurs de mémoire.

    Le script demande votre accord avant d’écrire. La réponse par défaut est non. Testez d’abord les disques avec DriveTime et la RAM avec MemHound.

LVM

  • a-m

    LVM marque un volume physique du pool comme manquant ou l’affiche comme unknown device. L’activation s’arrête avec le message Refusing activation of partial LV.

    Le script s’arrête. Le problème concerne la couche LVM et les métadonnées du pool ne sont pas en cause. Pour unknown device, le script vous renvoie à la couche RAID.

  • No thin pool found

    lvs -a n’affiche aucun thin pool. Le problème se situe sous les métadonnées du pool.

    Le script s’arrête et indique les vérifications en lecture seule du RAID et de LVM. Les commandes sont cat /proc/mdstat, md_checker, mdadm -E /dev/sdX3, pvs, vgs, lvs -a.

Métadonnées du thin pool

  • SSD cache

    Le pool utilise un cache SSD en lecture et écriture ou en écriture seule, ou Qtier conserve les données sur au moins deux niveaux.

    Le script s’arrête avant toute modification et vous oriente vers le support QNAP. Avec un cache SSD en lecture seule, il demande d’abord si le cache est retiré ou désactivé pour ce pool.

  • thin_check

    LVM signale Check of thin pool … failed ou thin_check détecte des erreurs dans les métadonnées du pool.

    LVM Pool Repair traite ce cas. La section suivante présente les trois types de dommages.

  • metadata consistent

    thin_check ne détecte aucune erreur dans les métadonnées.

    Si seul l’indicateur needs_check est défini, le script le réinitialise. Avec cet indicateur, le pool démarre avec des métadonnées en lecture seule. Sinon, le problème se situe au-dessus du pool, dans le système de fichiers, ou en dessous, dans le RAID ou dans LVM.

Quand les métadonnées du thin pool sont en cause

LVM Pool Repair est un script shell avec un menu. Il répare via SSH les métadonnées d’un thin pool QNAP sous QTS. Son diagnostic distingue trois types de dommages, chacun avec sa propre procédure de réparation.

  • space map counts only

    Seuls les compteurs de la carte d’espace présentent des erreurs. Les arbres de mappage sont intacts. Le script prépare une copie réparée, la vérifie et l’écrit dans le pool après la saisie de YES.

  • damaged superblock

    Le superbloc principal est endommagé et il existe des copies de sauvegarde valides. Après la saisie de YES, le script restaure le superbloc à partir de la copie valide la plus récente.

  • mapping tree errors

    Des parties de l’arbre de mappage des blocs d’un volume sont endommagées. Le pool utilise une copie réparée pour un montage de test en lecture seule. Vérifiez vos données avant que le script écrive cette copie. À la lecture, les blocs des plages supprimées apparaissent ensuite comme vides.

Avant toute écriture de réparation dans les métadonnées d’origine, le script en sauvegarde une image et la compare au périphérique pour la vérifier. Un test utilise 600 fichiers de 4 MiB sur un volume dont le mappage est endommagé. Après la réparation, 534 fichiers restent intacts. Les 66 fichiers qui contiennent des données dans les plages supprimées sont modifiés.

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