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.
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.
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
cat /proc/mdstatmd1.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
pvs · vgsvg1.Métadonnées du thin pool
Le thin pool, par exemple
lvs -atp1, 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.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.
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.
Vérifier le RAID
/proc/mdstatliste chaque ensemble md avec son état et ses membres.md_checkerliste les ensembles de données avec l’état de chaque disque.cat /proc/mdstat md_checker
Un ensemble marqué
inactiveindique un problème de RAID. Avec[4/3], un membre sur 4 manque et l’ensemble fonctionne en mode dégradé. La présence derecovery,resync,reshapeoucheckindique une opération en cours sur l’ensemble.Vérifier LVM
pvsliste les volumes physiques,vgsles groupes de volumes etlvs -ale pool et ses volumes.pvs vgs lvs -a
Dans
pvs, unmen troisième position dans Attr (a-m) signifie que LVM marque le volume physique comme manquant. Un PV affiché commeunknown devicen’existe pas sur le système. Silvs -an’affiche aucun thin pool, le problème se situe sous les métadonnées, dans le RAID ou dans LVM.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. Unaen 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
Diagnostiquer les métadonnées du pool hors ligne
Seul
thin_checkexé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 → Vérifier le système de fichiers d’un volume qui ne se monte pas
Si
lvs -aindique 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-fsindiquent 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 messageRefusing 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 -an’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 … failedouthin_checkdé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_checkne détecte aucune erreur dans les métadonnées.Si seul l’indicateur
needs_checkest 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.
Pages associées
- LVM Pool Repair : script de réparation des métadonnées d’un pool à provisionnement fin QNAP →
- DriveTime : test de surface de disque pour un NAS QNAP →
- Tester la RAM d'un NAS QNAP : MemHound, mode Rescue et USB →
- StorageDiag : diagnostic exécuté sur le NAS →
- NAS QNAP lent en lecture/écriture : dépannage →