Passer au contenu principal

Systèmes de fichiers

Sélection d'un type de système de fichiers​

Sélectionner le bon système de fichiers pour votre array Unraid ou cache pool est crucial. Cela vous aide à obtenir un équilibre entre performance, protection des données et fonctionnalités avancées. Unraid supporte plusieurs systèmes de fichiers modernes Linux, chacun avec ses propres forces uniques et cas d'utilisation spécifiques.

Système de fichiersProtection des donnéesEfficacité de l'espaceFonctionnalités avancéesMeilleur cas d'utilisation
XFSAucune redondance intégrée100 %Résistant à la corruptionPar défaut pour les disques d'une baie ; haute fiabilité
ZFSRAIDZ1/RAIDZ2/RAIDZ3, miroirs, etc.Varie selon le niveau de RAIDChecksums, Snapshots, RAIDBaies multi-appareils, VMs, Docker, utilisateurs avancés
BTRFSRAID 0/RAID 1/10/5/6, miroirsVarie selon le niveau de RAIDChecksums, Snapshots, RAIDBaies multi-appareils, mélange SSD/HDD, baies flexibles

XFS est le système de fichiers par défaut pour les lecteurs array dans Unraid. Il est connu pour sa robustesse et sa capacité à se remettre des corruptions après des arrêts inopinés ou des plantages. Chaque lecteur formaté avec XFS agit comme un système de fichiers autonome, ce qui rend la récupération de données simple sur tout système Linux.

  • Protection des données : Pas de redondance intégrée ; s'appuie sur la parité d'Unraid pour la protection.
  • Performance : Cohérent et fiable.
  • Meilleur pour : Disques Array, surtout lorsque la stabilité et la facilité de récupération de données sont des priorités.
Additional Notes
  • Mélanger différents types de systèmes de fichiers dans votre système Unraid est tout à fait acceptable ; le système de parité d'Unraid fonctionne indépendamment du système de fichiers utilisé.
  • Formatez toujours et partitionnez les disques dans Unraid pour assurer la compatibilité.
  • Les systèmes Linux peuvent lire ces systèmes de fichiers nativement ; cependant, Windows et macOS nécessitent des logiciels supplémentaires pour y accéder.
  • Vous pouvez chiffrer des disques pour une sécurité accrue, mais gardez à l'esprit que les disques chiffrés peuvent poser des défis pour la récupération en cas de corruption.
  • Pour les disques de transfert ou les appareils externes, il est recommandé d'utiliser le plugin Unassigned Devices, qui prend en charge des systèmes de fichiers supplémentaires.

:::tip[Still besoin d'aide pour choisir?

  • Pour les disques de baie : XFS est généralement le meilleur choix pour la plupart des utilisateurs.
  • Pour des performances élevées ou des fonctionnalités avancées : Choisissez ZFS ou BTRFS pour cache pools ou des configurations multi-appareils.
  • Pour les baies mixtes ou en expansion : BTRFS est idéal si vous voulez utiliser différentes tailles de disques ou ajouter ou retirer facilement des appareils.

Si vous êtes incertain, commencer avec les paramètres par défaut est une bonne approche : utilisez XFS pour les disques array et BTRFS pour les cache pools.

:::

Définir un type de système de fichiers​

Lors de l'ajout d'un nouveau disque à Unraid, vous pouvez sélectionner le type de système de fichiers qui correspond le mieux à vos besoins. Le système de fichiers détermine comment les données sont organisées et protégées sur le disque.

Pour définir le type de système de fichiers :

  1. Définir le paramètre par défaut globalement :

    • Accédez à Settings → Disk Settings pour définir le système de fichiers par défaut pour les nouveaux disques array uniquement.
    • Unraid utilise par défaut XFS pour les disques array.
    • Remarque : Il n'y a actuellement aucun paramètre par défaut global pour les cache pools. Ils seront toujours par défaut sur BTRFS si laissés sur « auto ».

  2. Définir le système de fichiers pour un disque individuel :

    • Arrêtez le array.
    • Cliquez sur le lecteur dans l'onglet Principal.
    • Choisissez le type de système de fichiers souhaité dans le menu déroulant.
    • Si vous sélectionnez auto, Unraid utilisera le paramètre par défaut global.
    • Pour les cache pools multi-appareils, seuls BTRFS ou ZFS sont pris en charge.

Création d'un système de fichiers (formatage)​

Avant d'utiliser un nouveau disque dans Unraid, vous devez le formater avec le système de fichiers choisi. Souvenez-vous, le formatage effacera tout le contenu existant sur le disque.

Pour commencer avec le formatage :

  1. Démarrez le array.
  2. Identifier les disques non montables : Les disques qui ne sont pas reconnus apparaîtront comme non montables.
  3. Vérifiez la sélection des disques : Vérifiez que tous les disques non montables sont ceux que vous souhaitez formater.
  4. Confirmez et formatez : Cochez la case pour confirmer, lisez attentivement la boîte de dialogue d'avertissement, et cliquez sur Formater.
  5. Surveillez le processus : Le processus de formatage va démarrer. Pour les nouveaux disques, Unraid réécrira d'abord la table de partition.
  6. Attendez la fin : Le formatage prend généralement quelques minutes. Si vous ne voyez pas de progression, rafraîchissez l'onglet Principal.

Une fois le formatage terminé, le disque est prêt à stocker des fichiers.

Changer un type de système de fichiers​

Vous pourriez vouloir changer le type de système de fichiers sur un disque spécifique pour profiter de nouvelles fonctionnalités ou pour assurer la compatibilité avec vos autres disques.

avertissement

Changer le type de système de fichiers effacera toutes les données existantes sur le disque. Pensez toujours à sauvegarder les fichiers importants avant de commencer.

Pour changer le type de système de fichiers sur un disque particulier :

  1. Arrêtez la baie : Commencez par arrêter votre array pour vous assurer qu'aucune opération n'est en cours pendant le changement.
  2. Sélectionnez le disque : Dans l'onglet Principal, cliquez sur le disque pour lequel vous voulez changer le format.
  3. Choisissez le nouveau système de fichiers : Dans le menu déroulant, sélectionnez le format de système de fichiers souhaité. Si vous avez plusieurs disques à modifier, répétez cette étape pour chacun.
  4. Démarrez la baie : Une fois que vous avez sélectionné les nouveaux systèmes de fichiers, redémarrez votre array.
  5. Formater les disques non montables : L'onglet Principal affichera une option pour formater les disques non montables. Prenez un moment pour vérifier la liste et assurez-vous que seuls les disques que vous souhaitez modifier sont inclus.
  6. Confirmez et formatez : Cochez la case pour confirmer le changement, puis cliquez sur le bouton Formater pour continuer.
  7. Attendez la fin du processus : Le formatage prend généralement juste quelques minutes. Si vous constatez que le statut ne se met pas à jour, vous pouvez rafraîchir l'onglet Principal pour vérifier la progression.

Si vous rencontrez des problèmes, n'hésitez pas à visiter les forums Unraid. Joignez votre fichier de diagnostic système zip (trouvé sous Outils → Diagnostics) pour obtenir de l'aide.

Conversion vers un nouveau type de système de fichiers​

important

À partir d'Unraid 7.2, la page Principale avertira si des disques de l'array ou du pool sont formatés dans des systèmes de fichiers obsolètes :

  • Tous les disques formatés en ReiserFS doivent être migrés vers un autre système de fichiers dès que possible, car ils ne seront plus utilisables dans une future version d'Unraid (probablement Unraid 7.3).
  • Tous les disques formatés dans une ancienne version de XFS doivent être migrés avant 2030.

Ce processus est particulièrement courant pour les utilisateurs passant du ReiserFS obsolète (utilisé dans les anciennes versions d'Unraid) au XFS ou au BTRFS, mais il s'applique à toute conversion de système de fichiers.

important

Ce processus nécessite de déplacer temporairement vos données vers un autre emplacement. Assurez-vous d'avoir suffisamment d'espace libre ailleurs dans votre array ou sur un appareil externe avant de commencer.

Pour convertir en toute sécurité vers un nouveau type de système de fichiers :

  1. Copiez toutes les données du lecteur : Déplacez vos fichiers vers un autre emplacement. Cela pourrait être un autre lecteur dans votre array, un cache pool, ou une sauvegarde externe.
    • Avant Unraid 7.0, vous devrez déplacer les fichiers manuellement.
    • À partir de Unraid 7.0, vous pouvez déplacer des fichiers utiliser 'mover' pour vider un disque de la matrice vers d'autres disques de la matrice via la ligne de commande.
    • À partir de Unraid 7.2, vous pouvez vider un disque de la matrice vers d'autres disques de la matrice via le WebGUI :
      • Naviguez vers Principal → Opération de la matrice et arrêtez la matrice.
      • Naviguez vers Paramètres → Paramètres de partage global. Dans la zone Vider disque(s), sélectionnez le(s) disque(s) à vider et Appliquer. Note : ce statut sera automatiquement supprimé lorsque la matrice est arrêtée.
      • Naviguez vers Principal → Opération de la matrice et démarrez la matrice.
      • Sur Principal → Opération de la matrice cliquez sur Déplacer (ou attendez que le mover s'exécute selon son calendrier normal).
      • Mover vide le disque selon vos paramètres de partage. Notez que les fichiers à la racine du lecteur sont en dehors de tout partage et ne seront pas déplacés.
      • Vérifiez Outils → Journal du système pour les messages concernant les fichiers qui n'ont pas pu être déplacés en raison d'une utilisation ou d'un manque d'espace libre.
    • Naviguez vers Principal → Périphériques de la matrice et explorez le disque pour confirmer qu'il est vide. Ne continuez que lorsque vous êtes certain que le disque est vide.
  2. Changez le type de système de fichiers : Suivez la procédure pour changer un type de système de fichiers. Cela formatera le lecteur et effacera tout le contenu, vous laissant avec un lecteur vierge dans le nouveau format.
  3. Copiez vos données arrière : (Facultatif) Selon l'endroit où vous avez déplacé les fichiers, vous voudrez peut-être les déplacer de nouveau sur le disque nouvellement formaté.
  4. Répétez au besoin : Si vous avez plus d'un disque à convertir, répétez ces étapes pour chaque disque, en transférant les données selon les besoins.

:::note[Timing]

Le processus peut prendre plusieurs heures, en fonction de la quantité de données et de la vitesse de vos lecteurs. La majeure partie du temps est consacrée à la copie des fichiers, qui peut être effectuée sans surveillance.

:::

Reformatage d'un disque​

Reformater un lecteur dans Unraid effacera toutes vos données et créera un nouveau système de fichiers vide. Ce processus est utile pour résoudre les erreurs de système de fichiers persistantes ou pour repartir à zéro avec un nouveau format.

avertissement

Le reformatage effacera définitivement toutes les données sur le lecteur. Sauvegardez toujours les fichiers importants avant de commencer.

Pour reformater en toute sécurité votre disque :

  1. Arrêtez la matrice.
  2. Changez le type de système de fichiers :
    • Allez à l'onglet Principal et cliquez sur le disque que vous souhaitez reformater.
    • Sélectionnez un type de système de fichiers différent (par exemple, changez de XFS à BTRFS).
    • Démarrez le array, et le disque s'affichera comme non montable.
    • Lorsque vous y êtes invité, formatez le disque.
  3. (Optionnel) Revenez à votre type de système de fichiers d'origine :
    • Arrêtez à nouveau le array.
    • Changez le système de fichiers à votre type préféré.
    • Démarrez le array et formatez à nouveau le disque.

Ce processus simple garantit que le lecteur est complètement effacé et formaté comme vous le souhaitez. Le processus de formatage prend généralement juste quelques minutes.

Reformatage d'un disque cache​

Parfois, il est nécessaire de reformater un disque cache pour les raisons suivantes :

  • Pour changer le type de système de fichiers (par exemple, de BTRFS à XFS ou vice versa)
  • Pour corriger des erreurs persistantes du système de fichiers
  • Pour démarrer à neuf pour de nouvelles charges de travail

Procédure recommandée pour reformater un disque de cache

  1. Arrêtez la matrice.
  2. Désactivez les services Docker et VM dans Paramètres.
  3. Démarrez la baie (cela empêchera les onglets Docker et VM d'apparaître).

Pour déplacer les données hors du cache :

  1. Définissez le stockage partagé et l'action du Mover (cache → array) : Pour chaque partage ayant des fichiers dans le cache, définissez le Stockage principal à la source cache pool et le Stockage secondaire à l'array. Réglez l'action du Mover sur cache → array.
    • Notez tout partage que vous modifiez et leurs réglages d'origine.
  2. Exécutez le Mover : Exécutez le Mover depuis l'onglet Principal. Attendez qu'il finisse et assurez-vous que le cache est vide.
    • Si des fichiers restent, arrêtez et consultez les forums pour obtenir de l'aide.

Pour reformater le disque cache :

  1. Arrêtez la matrice.
  2. Définissez le format du disque de cache (choisissez entre XFS ou BTRFS).
    • Pour un cache à un seul disque, XFS est l'option recommandée.
    • Notez que XFS est disponible uniquement si vous avez un seul emplacement de cache.
  3. Démarrez la matrice.
  4. Formatez le disque cache :
    • Confirmez que seul le disque du cache est répertorié comme non montable.
    • Procéder au formatage du disque.

Pour restaurer les données et les paramètres :

  1. Restaurez les paramètres de partage : Pour chaque partage que vous avez modifié, rétablissez les valeurs originales de Stockage principal et Stockage secondaire.
  2. Déplacez les données (array → cache) : Réglez le Stockage principal à la destination cache pool et le Stockage secondaire à l'array pour chaque partage que vous avez changé. Réglez l'action du Mover sur array → cache, puis exécutez à nouveau le Mover pour déplacer vos données de retour vers le cache.
  3. Arrêtez la matrice.
  4. Réactivez les services Docker et VM.
  5. Démarrez la matrice.

:::note[Timing]

Le temps nécessaire pour déplacer les données avec le Mover et formater le disque peut varier de plusieurs minutes à plusieurs heures, selon la quantité de données et la vitesse du disque.

:::

Opérations BTRFS​

Maintenir vos pools BTRFS dans Unraid est essentiel pour assurer leur bon fonctionnement et la sécurité de vos données. Deux outils clés que vous voudrez utiliser régulièrement sont Balance et Scrub. Ces opérations aident à résoudre les problèmes d'allocation d'espace, à optimiser l'utilisation de votre stockage, et à protéger vos données contre la corruption cachée.

Décomposons ce que fait chaque opération et quand les utiliser :

L'opération de Balance redistribue les données et les métadonnées à travers votre pool BTRFS. Ce processus aide à libérer de l'espace, résout les problèmes d'allocation et peut corriger les erreurs "espace insuffisant sur le périphérique" même quand de l'espace semble disponible.

Quand exécuter Balance

  • Lorsque vous rencontrez des erreurs de type « espace insuffisant sur l'appareil » mais que vous avez de l'espace libre.
  • Après avoir ajouté ou retiré des disques dans un pool.
  • Pour optimiser l'utilisation de l'espace et améliorer les performances.

Comment exécuter Balance

  1. Accédez au pool : Dans le WebGUI, cliquez sur le pool dans l'onglet Principal et sélectionnez Balance.
  2. Ajoutez des paramètres (optionnels) : Si nécessaire, ajoutez des paramètres pour une utilisation avancée (consultez l'aide d'Unraid pour plus de détails).
  3. Démarrez le processus : Cliquez sur Démarrer pour commencer le processus.

:::note[Timing]

Les opérations de Balance peuvent prendre de quelques minutes à plusieurs heures, selon la taille du pool et la quantité de données.

:::

astuce

Tant Balance que Scrub peuvent être effectués pendant que le système est en ligne, mais gardez à l'esprit que la performance peut être affectée pendant ces opérations. Vous pouvez surveiller l'avancement dans le WebGUI.

Pour plus de détails sur les fonctionnalités avancées BTRFS, consultez la documentation officielle BTRFS.

Disques non assignés​

Les lecteurs non assignés sont des dispositifs de stockage connectés à votre serveur Unraid qui ne font pas partie de l'array principal ou de tout cache pool. Vous pouvez utiliser ces lecteurs pour transférer des fichiers, créer des backups, ou fournir un stockage rapide pour des machines virtuelles.

note

Tous les lecteurs connectés à votre serveur au démarrage de l'array comptent vers votre limite de licence de périphériques attachés Unraid, même s'ils ne sont pas assignés à l'array ou à un pool.

Utilisations courantes pour les disques non assignés

  • Connectez des disques amovibles pour des transferts de fichiers ou des sauvegardes faciles.
  • Utilisez des disques dédiés pour des tâches haute performance comme exécuter des machines virtuelles ou pour du stockage temporaire de données.

Utilisation des plugins Unassigned Devices​

Pour tirer le meilleur parti de vos disques non assignés, envisagez d'installer les plugins suivants depuis l'onglet Apps :

  • Périphériques non attribués: Ce plugin vous permet de monter, partager et gérer des disques avec des systèmes de fichiers pris en charge par Unraid, comme XFS, BTRFS ou NTFS.

  • Unassigned Devices Plus : Cette extension élargit vos options en supportant des systèmes de fichiers supplémentaires, y compris ExFAT et HFS+.

Ces plugins permettent :

  • De monter et démonter facilement des disques depuis l'interface web d'Unraid.
  • Partager vos disques non assignés sur le réseau.
  • D'automatiser le montage lors du démarrage du serveur.
  • De formater ou d'effacer des disques pour une utilisation future.
  • De déconnecter en toute sécurité les disques USB ou externes sans tracas.

Pour plus de détails sur l'installation et la gestion des plugins, consultez Plugins.

Dépannage​

Le disque apparaît comme non montable​

Si vous voyez qu'un disque dans Unraid est non montable, cela peut être dû à deux raisons principales :

  1. Nouveau lecteur ajouté : Si vous venez d'ajouter un nouveau lecteur à votre configuration, il apparaîtra comme non montable jusqu'à ce que vous le formatiez. Le formatage crée un système de fichiers qui permet au disque de stocker des fichiers. Vous pouvez trouver les étapes pour formater un lecteur ici.

  2. Problèmes de système de fichiers : Si un lecteur qui fonctionnait auparavant montre soudainement comme non montable, il a probablement un problème de système de fichiers. Cela peut arriver en raison d'arrêts inattendus, de problèmes lors de l'écriture de données, ou si le lecteur a été marqué comme désactivé (ce qui apparaît comme un 'x' rouge dans le WebGUI).

important

Do not format an unmountable drive unless you are okay with losing all the data on it. Formatting will erase everything and update the parity information, making recovery impossible. Always try to fix the file system first.

Si votre disque est non montable :

  1. Identifiez la situation : Déterminez s'il s'agit d'un nouveau disque ou d'un disque fonctionnant précédemment.
  2. Pour les nouveaux disques : Formatez le disque pour créer un nouveau système de fichiers (consultez les étapes de formatage).
  3. Pour les lecteurs qui fonctionnaient auparavant : Effectuez une vérification ou une réparation du système de fichiers (voir Vérification d'un système de fichiers). Évitez de formater si vous souhaitez conserver les données.
note

Si un lecteur est à la fois non montable et désactivé ('x' rouge), exécutez d'abord la vérification/réparation du système de fichiers sur le lecteur émulé. Si le lecteur émulé est également non montable et que vous tentez de le reconstruire, le nouveau lecteur sera également non montable.

Réparer le système de fichiers prend généralement moins de temps que de reconstruire le lecteur, vous permettant d'accéder à vos données sans rien perdre. Rappelez-vous, reconstruire un lecteur ne résout pas les problèmes de système de fichiers ; il assure simplement que le lecteur physique correspond à celui émulé, en conservant les problèmes existants.

Why la parité n'est-elle pas suffisante?

Bien que la parité aide à récupérer un disque défectueux, elle ne peut pas résoudre les problèmes de système de fichiers. Si le système de fichiers est corrompu, la parité ne fera que reproduire cette corruption sur le nouveau disque.

Si vous n'êtes pas sûr :

  • Téléchargez les journaux de votre système en naviguant vers Outils → Diagnostiques.
  • Pour une assistance experte, postez votre problème ainsi que les diagnostics sur les forums d'Unraid.
Just pour réitérer
  • Ne formatez que les disques non montables s'ils sont neufs ou si vous souhaitez effacer toutes les données.
  • Utilisez la vérification/réparation du système de fichiers pour corriger les fichiers corrompus ; ne comptez pas sur la parité pour résoudre ces problèmes.
  • Pour les cache pools avec plusieurs disques, envisagez d'utiliser soit le BTRFS soit le ZFS.
  • Vérifiez toujours avant de formater ou de réparer des disques pour éviter la perte accidentelle de données.

Vérifier un système de fichiers​

Si un disque qui montait sans problème auparavant montre maintenant comme non montable, cela indique généralement une corruption du système de fichiers. Cela peut résulter d'un arrêt inapproprié, d'une opération d'écriture échouée, ou du disque étant marqué comme désactivé dans le WebGUI. Vérifier et réparer le système de fichiers est généralement plus rapide et plus sûr que de reconstruire, il est donc conseillé d'essayer cela avant de formater ou reconstruire le disque.

important

Si le WebGUI suggère de formater un lecteur non montable, ne formatez pas à moins que vous n'ayez l'intention d'effacer toutes les données. Le formatage détruira le contenu du lecteur et mettra à jour la parité, rendant la récupération impossible.

Préparation à la vérification ou à la réparation

  1. Identifiez le type de système de fichiers :

    • Accédez à l'onglet Principal et sélectionnez votre disque (ex : Disque 3, Cache).
    • Trouvez le type de système de fichiers (doit être XFS, BTRFS ou ZFS).

  2. Démarrez le réseau en mode correct :

    • Pour XFS, démarrez la array en mode maintenance.
    • Pour BTRFS, démarrez l'array en mode normal pour un scrub ou en mode maintenance pour une réparation.
    • Pour ZFS, référez-vous à la section ZFS ci-dessous.

  3. Handle emulated disks: If the disk is disabled and being emulated, run the check/repair on the emulated disk before attempting a rebuild. If the emulated disk is unmountable, the rebuilt disk will also be unmountable.

Messages d'erreur courants

MessageSignification / Action
Superblock a un mauvais nombre magiqueCorruption sévère; tentez une réparation du système de fichiers.
Système de fichiers est saleArrêt non net ; effectuez une vérification du système de fichiers.
Corruption de métadonnées détectéeLes structures du système de fichiers sont endommagées ; initier une réparation.
Aucun BTRFS valide trouvéLe disque peut ne pas appartenir à un pool valide; vérifiez les assignations de pool.
Montage: mauvais type fs, mauvaise option, etc.Sélection incorrecte du système de fichiers ou disque non formaté.
Impossible de monter /dev/mdX: La structure a besoin d'un nettoyageLe système de fichiers est corrompu; effectuez une réparation.

Via le WebGUI​

  1. Démarrez l'array : Démarrez l'array en mode correct (reportez-vous aux étapes ci-dessus).
  2. Sélectionnez le disque : Allez à l'onglet Principal et sélectionnez le disque à vérifier.
  3. Accédez aux options de vérification : Faites défiler jusqu'à Vérifier l'état du système de fichiers.
  4. Pour XFS (Unraid 7.0+) : Vous verrez un bouton VÉRIFIER sans options à entrer. Le système détermine automatiquement les actions nécessaires en fonction des résultats de la vérification.
  5. Pour d'autres systèmes de fichiers : Entrez toute option nécessaire (pour les détails, consultez Aide en haut à droite).
  6. Commencez la vérification : Cliquez sur Vérifier pour lancer.
  7. Surveillez les progrès : Surveillez les progrès dans la boîte de sortie. Utilisez Rafraîchir si nécessaire.
  8. Passez en revue les résultats : Passez en revue les résultats. Si vous n'êtes pas sûr, copiez la sortie et postez-la sur les forums pour obtenir des conseils.

Flux de travail de réparation automatique XFS (Unraid 7.0+)​

À partir d'Unraid 7.0, la réparation du système de fichiers XFS est maintenant entièrement automatisée via le WebGUI :

  1. Vérification initiale : Cliquez sur le bouton VÉRIFIER (aucune option à entrer)
  2. Résultats de la vérification :
    • Aucune corruption détectée : Affiche "aucune corruption du système de fichiers détectée" et le bouton VÉRIFIER reste
    • Corruption détectée : Affiche "corruption du système de fichiers détectée" et un bouton RÉPARER apparaît
  3. Processus de réparation : Cliquez sur RÉPARER pour réparer automatiquement le système de fichiers
  4. Actions supplémentaires : Si nécessaire, un bouton ZERO LOG peut apparaître
  5. Achèvement : Affiche "système de fichiers réparé" lorsque le processus est terminé

Ce système automatisé élimine le besoin pour les utilisateurs d'entrer manuellement des options de réparation et garantit que la séquence de réparation correcte est suivie.

Via la ligne de commande​

Pour vérifier un système de fichiers XFS via la ligne de commande :

  • Démarrez le array en module de maintenance.
  • Exécutez la commande suivante : xfs_repair -v /dev/mdXp1
  • Remplacez X par le numéro de disque (par ex., /dev/md1p1).
  • Pour XFS chiffré, utilisez /dev/mapper/mdXp1.
  • Pour les disques qui ne sont pas dans l'array : xfs_repair -v /dev/sdX1
  • Assurez-vous d'utiliser le bon identificateur de périphérique.
avertissement

Exécuter cette commande sur un disque array en dehors du module de maintenance invalidera la %%parity|parité%%.

astuce
  • Les réparations du système de fichiers sont généralement plus rapides qu'une reconstruction complète et peuvent restaurer l'accès sans perte de données.
  • Reconstruire un disque ne résout pas la corruption du système de fichiers ; effectuez toujours une vérification ou une réparation d'abord.
  • Si vous avez des doutes, publiez vos diagnostics et messages d'erreur sur les forums d'Unraid pour obtenir de l'aide d'experts.

Réparation d'un système de fichiers​

Si une vérification de votre système de fichiers trouve des erreurs, vous devrez peut-être exécuter une réparation pour retrouver l'accès à vos données. Les réparations prennent généralement moins de temps qu'une reconstruction complète, mais il est important de lire attentivement la sortie et de demander de l'aide sur les forums si vous n'êtes pas sûr de quelque chose.

:::note[Timing]

Les réparations peuvent prendre de quelques minutes à plusieurs heures, surtout pour les systèmes de fichiers plus grands ou lourdement corrompus. Le progrès peut sembler lent, mais vous pouvez vérifier l'activité en regardant les statistiques de lecture/écriture sur la page principale.

:::

Préparation à la réparation

  1. Identifier le type de système de fichiers : Allez à l'onglet Principal, cliquez sur le disque, et découvrez de quel type de système de fichiers il s'agit (XFS, BTRFS, ou ZFS).

  2. Démarrez le réseau en mode correct :

    • Pour XFS : Utilisez module de maintenance.
    • Pour BTRFS : Utilisez mode normal pour un scrub ; utilisez module de maintenance pour une réparation.
    • Pour ZFS : Utilisez le mode normal et exécutez un scrub pour vérifier les erreurs. Consultez la page de stockage ZFS pour obtenir des conseils sur l'entretien et les procédures de réparation des pools ZFS.

  3. Gérer les disques émulés : Si le disque est désactivé et est en cours d'émulation, effectuez la réparation sur le %%emulated disk|disque émulé%% avant de tenter une reconstruction.

Via le WebGUI​

  1. Démarrez le réseau: Démarrez le array en mode correct (voir la section ci-dessus).
  2. Sélectionnez le disque: Allez à l'onglet Principal et cliquez sur le disque que vous souhaitez réparer.
  3. Accéder aux options de réparation: Faites défiler vers le bas jusqu'à Vérification de l'état du système de fichiers.
  4. Pour XFS (Unraid 7.0+) : Le processus de réparation est entièrement automatisé. Cliquez sur VÉRIFIER, puis RÉPARER si une corruption est détectée, et ZERO LOG si on vous le demande.
  5. Pour d'autres systèmes de fichiers : Supprimez toutes les options qui exécuteraient le processus en mode vérification seule (comme --readonly pour BTRFS).
  6. Ajoutez les options suggérées : Si vous y êtes incité, ajoutez les options suggérées comme indiqué dans les résultats de vérification.
  7. Commencer la réparation : Cliquez sur Vérifier pour commencer la réparation.
  8. Surveillez les progrès : Gardez un œil sur les progrès dans la boîte de sortie. Utilisez Rafraîchir si nécessaire.
  9. Vérifiez les fichiers perdus : Si vous remarquez un dossier lost+found après la réparation, il peut contenir des fichiers ou dossiers qui n'ont pas pu être entièrement récupérés. Utilisez des sauvegardes ou la commande file de Linux pour identifier le contenu si nécessaire.
info

Si vous n'êtes pas sûr de la sortie, copiez-la et partagez-la sur les forums Unraid pour une aide experte. Utilisez l'option de formatage de code pour la rendre lisible.

Via la ligne de commande​

  • Démarrez le array en module de maintenance.
  • Exécutez la commande suivante : xfs_repair /dev/mdXp1. Remplacez X par le numéro du disque (par ex., /dev/md1p1).
  • Pour un XFS chiffré, utilisez : /dev/mapper/mdXp1.
  • Si vous êtes invité à utiliser -L, relancez la commande ainsi : xfs_repair -L /dev/mdXp1. Ceci est généralement sûr et nécessaire pour compléter la réparation.
  • Pour les disques qui ne font pas partie de l'array : xfs_repair /dev/sdX1.
précaution

Exécuter cette commande sur un disque array en dehors du module de maintenance invalidera la parité.

After la réparation
  • Arrêtez et redémarrez le array en mode normal.
  • Le lecteur devrait maintenant être monté et accessible.
  • Si vous voyez un dossier lost+found, vérifiez son contenu pour d'éventuels fichiers importants.

Si vous ne comprenez pas le résultat de la réparation ou si le processus échoue, partagez vos diagnostics et le journal de réparation sur les forums d'Unraid pour obtenir de l'aide supplémentaire.