Erreurs de corruption du cache Unraid : diagnostiquer avant de réparer

Étapes à suivre

1. Arrêter les changements et conserver l’état observé

   Notez l’heure de l’alerte, le nom du pool et les applications qui y écrivent. Arrêtez proprement les conteneurs et machines virtuelles concernés lorsque cela est possible, puis désactivez leurs services si une intervention exige que les fichiers soient fermés. Évitez les redémarrages répétés avant d’avoir récupéré les diagnostics : certains indices peuvent disparaître ou devenir plus difficiles à interpréter. Conservez les messages complets, pas seulement le compteur d’erreurs. Si le pool est passé en lecture seule, ne cherchez pas immédiatement à forcer l’écriture. Cette réaction peut protéger le système de fichiers pendant que vous préparez une copie ou une analyse adaptée.

2. Identifier le pool, ses membres et son système de fichiers

   Dans Main, relevez le nom du pool, les numéros de série des disques et le format utilisé. Un emplacement appelé cache n’est pas nécessairement un pool Btrfs à deux disques ; il peut utiliser une autre organisation. Notez aussi la présence ou l’absence de redondance effective. Deux disques visibles ne suffisent pas à démontrer que toutes les données possèdent une copie saine. Vérifiez les profils et l’état indiqués par la documentation de votre configuration. Distinguez ce pool de la grappe principale et de son disque de parité. Cette identification détermine les outils pertinents et évite d’appliquer une réparation destinée à un autre type de volume.

3. Séparer erreur de données et problème de liaison

   Examinez les diagnostics pour repérer les erreurs d’entrée-sortie, les pertes de périphérique, les alertes de température et les informations de santé disponibles. Un câble, une alimentation ou un contrôleur instable peut produire des symptômes qu’une réparation logique ne corrigera pas durablement. À l’inverse, l’absence d’alerte matérielle ne prouve pas que le système de fichiers est cohérent. Comparez l’heure des erreurs avec une coupure, une modification de matériel ou une forte charge. Ne remplacez pas plusieurs composants en même temps sans noter les changements. Une observation organisée permet ensuite de vérifier si l’action choisie traite la cause plutôt que son seul effet visible.

4. Mettre à l’abri les éléments encore récupérables

   Si les données restent lisibles, copiez d’abord les fichiers irremplaçables et les données applicatives nécessaires vers un stockage distinct. Pour une base active, utilisez son export prévu lorsque cela reste possible et cohérent ; une copie brute à chaud n’est pas toujours une sauvegarde exploitable. Priorisez les documents uniques, puis les configurations et les médias récupérables ailleurs. Vérifiez les fichiers copiés et conservez les messages d’échec. Ne transformez pas la copie en déplacement avec suppression de la source. Si le support présente des signes de défaillance grave ou des lectures qui se dégradent, limitez les essais et envisagez une assistance spécialisée avant d’épuiser ses dernières possibilités de lecture.

5. Choisir un contrôle adapté sans réparation aveugle

   Consultez la procédure Unraid du système de fichiers identifié. Un scrub Btrfs ou ZFS vérifie les sommes de contrôle et peut réparer lorsque la redondance fournit une copie valide ; il ne reconstitue pas magiquement des données sans référence saine. XFS utilise un parcours de vérification différent. Ne lancez pas un outil de réparation Btrfs agressif simplement parce qu’un forum cite son nom. Certaines opérations écrivent dans les métadonnées et peuvent compliquer la récupération. Préparez les diagnostics, les sauvegardes disponibles et l’objectif précis avant chaque étape. Si la procédure demande une cible technique, faites confirmer qu’elle correspond bien au pool concerné.

Conseils détaillés

Ne pas confondre formatage et réparation

L’option de formatage crée un nouveau système de fichiers ; elle ne retrouve pas les documents de l’ancien. Un pool qui apparaît non montable ne doit donc pas être formaté dans l’espoir qu’Unraid reconstruise ensuite automatiquement toutes ses applications. La parité de la grappe principale n’est pas une sauvegarde du cache, et Mover n’a peut-être jamais transféré les fichiers ouverts ou configurés pour rester sur le pool. Vérifiez l’emplacement réel des sauvegardes avant de réinitialiser. Si une recréation devient la solution choisie, elle doit suivre une décision explicite fondée sur des copies récupérables, avec une liste claire des données perdues ou conservées.

Restaurer les applications avec leurs dépendances

Après correction matérielle ou reconstruction documentée, restaurez les fichiers dans les emplacements attendus par les conteneurs et machines virtuelles. Vérifiez les chemins, les droits, les bases et les versions applicatives avant de relancer tous les services. Commencez par une application et contrôlez ses journaux, puis passez à la suivante. Une interface qui démarre avec une configuration vide peut signaler un nouveau dossier créé au mauvais endroit. Ne considérez pas ce démarrage comme une restauration réussie. Comparez les comptes, les fichiers et les fonctions importantes avec votre inventaire, puis vérifiez que les sauvegardes reprennent vers une destination réellement distincte.

Surveiller la récidive et corriger le plan de protection

Conservez un relevé des compteurs après intervention et observez leur évolution sous une charge représentative. Si de nouvelles erreurs apparaissent, reprenez le diagnostic matériel et logique plutôt que de répéter indéfiniment la même réparation. Vérifiez aussi la capacité libre, les alertes et les fenêtres de maintenance. Révisez enfin la protection des dossiers restés sur le pool : appdata, images de machines virtuelles et bases peuvent être plus importants que des fichiers temporaires. Définissez une sauvegarde régulière adaptée à chaque application et testez sa restauration. L’incident est réellement traité lorsque les données sont utilisables et qu’une nouvelle défaillance dispose d’un chemin de reprise connu.

Comparer les situations

Questions fréquentes

Guides associés

• SSD pour cache Unraid : modèles, capacité et prix en France
• Quel PC pour After Effects ? RAM, GPU et cache SSD
• Sauvegarde 3-2-1 : organiser ses copies et tester la restauration