MergerFS - Maintenance

Procédures maintenance pool MergerFS.

Ajout Disque au Pool

Nouveau disque 2TB :

# 1. Formater
mkfs.ext4 -L disk3 /dev/sdX1

# 2. Créer point montage
mkdir /mnt/disk3

# 3. Ajouter fstab
echo "LABEL=disk3 /mnt/disk3 ext4 defaults,noatime 0 2" >> /etc/fstab
mount /mnt/disk3

# 4. Mettre à jour MergerFS fstab
nano /etc/fstab
# Modifier ligne : /mnt/disk*:/mnt/disk3 /mnt/storage fuse.mergerfs ...

# 5. Remonter pool
umount /mnt/storage
mount /mnt/storage

# 6. Vérifier
df -h /mnt/storage

Ajouter à SnapRAID :

# Éditer config
nano /etc/snapraid.conf
# Ajouter : data d3 /mnt/disk3

# Sync (long, calcul parity nouveau disque)
snapraid sync

Retrait Disque du Pool

Avant retrait :

# 1. Vérifier contenu
ls -la /mnt/diskX/

# 2. Déplacer données vers autres disques
rsync -av --remove-source-files /mnt/diskX/ /mnt/storage/

Retrait :

# 1. Démonter pool
umount /mnt/storage

# 2. Démonter disque
umount /mnt/diskX

# 3. Supprimer entrées fstab
nano /etc/fstab
# Supprimer lignes diskX et MergerFS

# 4. Mettre à jour MergerFS (sans diskX)
mount /mnt/storage

# 5. Retirer de SnapRAID
nano /etc/snapraid.conf
# Supprimer ligne data dX
snapraid sync

Rééquilibrage Données

Déplacer fichiers entre disques :

# Vérifier distribution
du -sh /mnt/disk*

# Déplacer manuellement (exemple)
mv /mnt/disk1/media/large-file.mkv /mnt/disk2/media/

# MergerFS handle automatiquement avec moveonenospc

Politique MergerFS :

# Changer policy création
setfattr -n user.mergerfs.create -v lfs /mnt/storage

# Vérifier
getfattr -n user.mergerfs.create /mnt/storage

Monitoring Santé

Espace disque :

# Par disque
df -h /mnt/disk*

# Pool total
df -h /mnt/storage

Performance :

# Test écriture
dd if=/dev/zero of=/mnt/storage/test bs=1M count=1000 conv=fdatasync
rm /mnt/storage/test

# Test lecture
dd if=/mnt/storage/large-file of=/dev/null bs=1M

Troubleshooting

Pool Ne Monte Pas

# Vérifier disques sources
mount | grep disk

# Monter manuellement
mount /mnt/disk1
mount /mnt/disk2
mount /mnt/storage

# Logs
journalctl -xe | grep mergerfs

Performance Dégradée

# Cache stats
getfattr -n user.mergerfs.cache.files /mnt/storage

# Flush cache
setfattr -n user.mergerfs.cache -v flush /mnt/storage

Ressources

Dernière mise à jour : 27 janvier 2026