Comment corriger les erreurs ZFS courantes dans Proxmox VE

ZFS est un système de fichiers puissant et résilient, largement utilisé avec Proxmox VE pour la gestion du stockage. Mais comme tout système, il peut rencontrer des erreurs : corruption de disques, pools dégradés, lenteurs ou messages d’alerte dans l’interface.

Dans cet article, nous passons en revue les erreurs ZFS les plus courantes sur Proxmox, et surtout comment les diagnostiquer et les corriger efficacement.

1. Pool ZFS « DEGRADED »

Symptôme :

Commande zpool status retourne :

state: DEGRADED

Cause :

Un ou plusieurs disques du pool sont inaccessibles ou en erreur.

Solution :

• Identifier le disque problématique :

  zpool status
  

• Remplacer le disque :

  zpool replace rpool old_disk new_disk
  

• Vérifier que le resilvering se lance :

  zpool status
  

2. Erreurs de checksum (checksum errors)

Symptôme :

errors: Permanent errors have been detected...

Cause :

Des données corrompues ont été détectées par ZFS.

Solution :

• Identifier les fichiers concernés avec :

  zpool status -v
  

• Restaurer les fichiers depuis une sauvegarde

• Vérifier les câbles SATA/SSD/RAID et l’alimentation

• Remplacer le disque si les erreurs persistent

3. Performances lentes avec ZFS

Symptômes :

• I/O élevés même sans activité

• VMs qui ralentissent

Causes possibles :

• Pas d’ARC suffisant (manque de RAM)

• Compression ou dedup activés inutilement

• Disques lents

Solutions :

• Ajouter plus de RAM (ZFS aime la mémoire !)

• Désactiver dedup sauf besoin spécifique

• Activer lz4 pour la compression (rapide et efficace)

  zfs set compression=lz4 rpool
  

4. ZFS refuse de créer un volume

Symptôme :

Message d’erreur lors de la création d’un disque virtuel :

cannot create 'rpool/vm-100-disk-0': dataset already exists

Cause :

Un volume avec le même nom existe déjà.

Solution :

• Vérifiez les volumes ZFS existants :

  zfs list
  

• Supprimez le dataset en conflit si inutile :

  zfs destroy rpool/vm-100-disk-0
  

5. Snapshots ZFS non supprimables

Symptôme :

Impossible de supprimer un snapshot avec zfs destroy.

Cause :

Le snapshot est toujours référencé par une réplication ou une dépendance.

Solution :

• Listez les snapshots :

  zfs list -t snapshot
  

• Utilisez la commande avec -r si besoin :

  zfs destroy -r rpool/data@snapshot1
  

6. Proxmox ne voit pas un pool ZFS

Symptôme :

L’interface ne liste pas le pool, bien qu’il soit monté.

Cause :

Le pool n’a pas été importé au démarrage, ou n’est pas activé.

Solution :

• Importer manuellement :

  zpool import
  zpool import rpool
  

• Ajouter une ligne dans /etc/zfs/zpool.cache si besoin :

  update-initramfs -u
  

Bonnes pratiques avec ZFS sous Proxmox

• Allouer 8 Go de RAM minimum

• Utiliser ZFS localement (éviter ZFS sur NFS/iSCSI)

• Activer la compression LZ4

• Faire des snapshots réguliers

• Monitorer avec zpool status et zfs list

• Sauvegarder régulièrement avec Proxmox Backup Server