ReFS

Troubleshooting ReFS - Guide de dépannage

📋 Vue d'ensemble

ReFS (Resilient File System) protège les données via des checksums et de l'auto-réparation, mais certains scénarios (perte d'alimentation, panne matérielle, corruption de métadonnées) peuvent rendre un volume RAW ou inaccessible.

Ce guide couvre les Event IDs critiques, les commandes de diagnostic, et les procédures de récupération basées sur la documentation officielle Microsoft. [46]

1️⃣ Event IDs à surveiller

📍 Journal Microsoft-Windows-DeviceSetupManager/Admin [46]

Event ID Signification Gravité
131 Structure du système de fichiers ne peut pas être corrigée 🔴 Critique
133 Erreur de checksum non corrigée (fichier/dossier concerné indiqué) 🔴 Critique
135 Volume formaté ReFS mais impossible à monter — état "recovery failed" 🔴 Critique
140 Volume RAW ou périphérique occupé 🟠 Élevé

📍 Journal Système

Event ID Signification
55 Erreur générique de système de fichiers
129 Réinitialisation du périphérique de stockage (timeout SAN/iSCSI)

📍 Journal VSS / Backup

Event ID Signification
12289 Échec de création de shadow copy
8193 Erreur VSS Writer

💡 Astuce terrain : L'Event ID 133 mentionne souvent le nom de l'objet corrompu (ex: "Object ID Table", "Container Table", "Duplicate Container Table"). Ces tables sont des métadonnées internes ReFS — leur corruption est un signe direct de problème disque ou de coupure brutale. [48][59]

2️⃣ Causes courantes de corruption [46]

3️⃣ Diagnostic initial

Étape 1 — Vérifier l'état du volume

Get-Volume | Select-Object DriveLetter, FileSystemType, HealthStatus, OperationalStatus

Étape 2 — Vérifier la version ReFS

fsutil fsinfo refsinfo <Drive>

Étape 3 — Identifier le matériel en cause

  1. Consulter les journaux d'événements pour des erreurs matérielles récurrentes.
  2. Lancer des diagnostics SMART sur tous les disques physiques.
  3. Remplacer immédiatement tout disque défaillant.
  4. Vérifier que firmware, BIOS et pilotes sont à jour et compatibles (surtout en S2D). [46]

4️⃣ Procédure de récupération — Volume RAW (Event 133/135)

⚠️ Important : Microsoft ne fournit aucun utilitaire de réparation en ligne pour ReFS comme chkdsk sur NTFS. La méthode officielle est le salvage vers un disque sain. [46][57]

Étape 1 — Préparer un disque de destination

Un second disque, de taille égale ou supérieure au volume corrompu.

Étape 2 — Lancer le salvage

refsutil salvage -s <SourceVolume> -d <DestinationFolder>

Étape 3 — Si le salvage échoue

5️⃣ Désactiver temporairement la validation d'intégrité

Si le volume ne monte toujours pas après un salvage échoué, une option avancée (à utiliser avec précaution, idéalement en coordination avec le support Microsoft) :

  1. Ouvrir regedit sur le système où le volume est monté.
  2. Naviguer vers : 
    HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\
  3. Définir RefsDisableVolumeIntegrityValidation à 0.
  4. Retenter le montage du volume.
  5. Si l'échec persiste, retenter le salvage, ou escalader vers un correctif kernel/registre via le support Microsoft. [46]

⚠️ Cette manipulation ne corrige pas la corruption — elle contourne temporairement une vérification pour permettre l'accès aux données.

6️⃣ Cas particulier : ReFS + Storage Spaces / S2D

Si le volume ReFS a l'Integrity Streams activé et repose sur Storage Spaces, le système peut auto-réparer certaines corruptions grâce à la redondance (mirror/parity). [50][52]

Actions recommandées :

# Lancer un health-check manuel sur le pool
Get-StoragePool | Get-PhysicalDisk | Get-StorageHealthAction

# Réparer un volume Storage Spaces après remplacement disque
Repair-VirtualDisk -FriendlyName "<NomDuVolume>"

7️⃣ Collecte des journaux de cluster (environnement S2D/CSV)

Si le volume ReFS problématique est un CSV (Cluster Shared Volume) dans un cluster Hyper-V/S2D :

Import-Module FailoverClusters

# Log des 15 dernières minutes, tous les nœuds
Get-ClusterLog -TimeSpan 15 -Destination C:\ClusterLogs -UseLocalTime

8️⃣ Tableau récapitulatif — Action par symptôme

Symptôme Event ID Action immédiate
Volume passé en RAW 133, 135 refsutil salvage, puis restaurer depuis backup
Structure système non corrigible 131 Vérifier matériel, tenter salvage
Montage impossible / périphérique occupé 140 Vérifier verrous, redémarrer service storage
Erreur checksum sur table interne 133 Vérifier SMART disques, envisager salvage
Réinitialisation stockage répétée 129 Vérifier réseau SAN/iSCSI, câblage, contrôleur
Échec shadow copy / backup 12289, 8193 Vérifier VSS Writers, espace disque libre
Volume CSV en échec (cluster) — Get-ClusterLog, analyser DiagnosticVerbose

9️⃣ Bonnes pratiques préventives

📖 Sources

ReFS - Présentation, Supervision et Dépannage

📚 Qu'est-ce que ReFS ?

ReFS est un système de fichiers moderne conçu par Microsoft pour Windows Server, optimisé pour :

⚠️ Important : ReFS n'est pas un remplacement universel de NTFS. Il est conçu pour des workloads spécifiques (virtualisation, stockage résilient). nakivo

🔧 Processus liés à ReFS

ReFS s'appuie sur plusieurs composants système :

Processus / Service Rôle
System (ntoskrnl.exe) Gestion kernel du système de fichiers 📁
Storage Spaces (storsvc.dll) Si ReFS est utilisé avec Storage Spaces
Filter Manager (fltmgr.sys) Gestion des filtres de système de fichiers
VSS (Volume Shadow Copy Service) Snapshots et backups
Cluster Service (clussvc.exe) Si utilisé en environnement cluster

💡 Astuce : Utilisez Get-Process et Get-Service pour surveiller l'activité liée au stockage :

Get-Service -Name "*stor*" | Select-Object Name, Status

🚨 Event IDs critiques à surveiller

📍 Journal Microsoft-Windows-DeviceSetupManager/Admin learn.microsoft

Event ID Signification Action
131 Problème d'initialisation du volume Vérifier l'état du disque
133 Volume passé en RAW Données inaccessibles - urgence !
134 Échec de montage du volume Métadonnées corrompues
135 Volume RAW ou inaccessible Réparation nécessaire
137 Corruption de métadonnées Checksum errors
140 Périphérique occupé ou erreur de montage Conflit d'accès

📍 Journal Système learn.microsoft

Event ID Signification
55 Erreur de système de fichiers (NTFS/ReFS)
129 Réinitialisation de l'appareil de stockage

📍 Journal VSS / Backup learn.microsoft

Event ID Signification
12289 Échec de création de shadow copy
8193 Erreur VSS Writer

🛠️ Commandes de diagnostic essentielles

# Vérifier l'état des volumes ReFS
Get-Volume | Where-Object FileSystemType -EQ "ReFS" | Select-Object DriveLetter, HealthStatus, OperationalStatus

# Vérifier l'intégrité avec ReFS (auto-correction si possible)
Repair-Volume -DriveLetter X -Scan

# Forcer une réparation (si nécessaire)
Repair-Volume -DriveLetter X -OfflineScanAndFix

# Logs de cluster (si environnement clusterisé)
Get-ClusterLog -UseLocalTime -Destination "C:\ClusterLogs"

⚡ Bonnes pratiques ReFS

✅ À faire :

❌ À éviter :

📊 Scénarios de dépannage rapide

Symptôme Event ID Action
Volume en RAW 133, 135 Repair-Volume, vérifier Storage Spaces
Échec de montage 134, 137, 140 Checksum errors → restaurer depuis backup
Backup VSS échoue 12289, 8193 Vérifier VSS Writers, espace libre
Performance lente - Vérifier fragmentation, privilégier 3-way mirror learn.microsoft

📖 Ressources officielles Microsoft

🎓 Quiz rapide (pour valider votre compréhension)

  1. Quel Event ID indique un volume ReFS passé en RAW ?
  2. Peut-on utiliser ReFS pour le volume système en production ?
  3. Quelle commande PowerShell répare un volume ReFS ?

(Réponses : 133/135 | Non, sauf preview | Repair-Volume)