AccueilDocumentationInstallationMCPSDKDémoCommunautéBlog
Dépannage

Pannes de disque

Remplacez un disque défaillant dans un déploiement RustFS et laissez RustFS réparer les données automatiquement.

RustFS utilise le codage d’effacement pour que les données restent lisibles et inscriptibles lorsque certains disques tombent en panne. Après le remplacement d’un disque défaillant, RustFS y répare automatiquement les données manquantes.

Démontez le disque défaillant

Avant de remplacer le disque dur physique, démontez le disque défaillant au niveau du système d’exploitation afin d’éviter des erreurs d’E/S dans le système de fichiers ou dans RustFS pendant le remplacement.

# Assume the failed disk is /dev/sdb
umount /dev/sdb

Remarques

  • Si le disque possède plusieurs points de montage, exécutez umount sur chacun d’eux.
  • Si l’erreur « device is busy » apparaît, arrêtez d’abord le service RustFS :
systemctl stop rustfs

Remplacez le disque défaillant

Après avoir physiquement remplacé le disque défaillant, vous devez partitionner et formater le nouveau disque, puis lui appliquer la même étiquette que le disque d’origine.

# Format as XFS and apply the same label as the original disk (RustFS requires XFS, like the other disks in the deployment)
mkfs.xfs -L DISK1 /dev/sdb

Exigences

  • Le nouveau disque est au moins aussi grand que le disque d’origine.
  • Utilisez le même système de fichiers que les autres disques (XFS ; voir le guide d’installation).
  • Nous recommandons de monter les systèmes de fichiers par étiquette (LABEL) ou par UUID, afin que les montages restent corrects si les noms de périphériques changent après un redémarrage.

Mettez à jour /etc/fstab ou la configuration RustFS

Vérifiez que les étiquettes ou les UUID des entrées de /etc/fstab pointent vers le nouveau disque. Le point de montage doit rester identique à celui indiqué dans RUSTFS_VOLUMES (dans /etc/default/rustfs), afin que le disque réparé rejoigne le cluster au même chemin.

# View current fstab
cat /etc/fstab

# Example fstab entry (no modification needed if labels are the same)
LABEL=DISK1 /data/rustfs0 xfs defaults,noatime 0 2

Conseils

  • Si vous utilisez un UUID :
blkid /dev/sdb
# Get the new partition's UUID, then replace the corresponding field in fstab
  • Après avoir modifié /etc/fstab, validez la syntaxe :
mount -a # If no errors, configuration is correct

Remontez le nouveau disque

Exécutez les commandes suivantes pour monter tous les systèmes de fichiers configurés et démarrer RustFS :

mount -a
systemctl start rustfs

Vérifiez que tous les systèmes de fichiers attendus sont montés :

df -h | grep /data/rustfs

Échecs de montage

Si un montage échoue, vérifiez que les étiquettes ou les UUID de /etc/fstab correspondent à ceux du système de fichiers cible.

Déclenchez et suivez la réparation des données

Dès que RustFS détecte un disque fraîchement formaté sur un point de montage connu, son scanner en arrière-plan y répare automatiquement les données manquantes. Aucune commande manuelle n’est requise. Confirmez que la récupération a commencé et suivez sa progression dans les journaux du service :

# For systemd-managed installations
journalctl -u rustfs -f

# Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY
tail -f /var/log/rustfs/rustfs.log

Vous pouvez aussi ouvrir la Console RustFS et vérifier l’état des disques du nœud concerné.

Remarques

  • La réparation s’exécute en arrière-plan et a généralement peu d’impact sur les requêtes des clients.
  • Une fois la réparation terminée, les journaux signalent le succès ou listent les objets dont la réparation a échoué.

Vérifications et remarques de suivi

  1. Surveillance des performances
  • La charge d’E/S peut fluctuer pendant la réparation. Nous recommandons de surveiller l’utilisation des disques et du réseau.
  1. Pannes par lot
  • Si plusieurs disques du même lot de fabrication tombent en panne, inspectez plus souvent les disques restants de ce lot.
  1. Tests de panne réguliers
  • Organisez régulièrement des exercices de panne de disque afin que votre équipe puisse s’exercer à la procédure de reprise.
  1. Fenêtres de maintenance
  • Lorsque le taux de panne est élevé, planifiez des fenêtres de maintenance dédiées pour accélérer le remplacement et la réparation.

Dépannage

Diagnostiquez et résolvez les problèmes de RustFS.

Pannes de nœud

Préparez un nœud de remplacement, mettez à jour sa configuration, rétablissez son appartenance au cluster et vérifiez la réparation des données.

On this page

Démontez le disque défaillantRemplacez le disque défaillantMettez à jour /etc/fstab ou la configuration RustFSRemontez le nouveau disqueDéclenchez et suivez la réparation des donnéesVérifications et remarques de suivi