Aller au contenu

PBS : job de sauvegarde en échec

RB-14Toutes architecturesNiveau 215 minQui : Client / MSP / MSP

Objectif. Comprendre pourquoi une sauvegarde nocturne a échoué, corriger et relancer avant la fin de la journée.

Diagnostic

  1. Lire la notification reçue (mail ou webhook) : elle liste les VMs en erreur.
  2. GUI PVE : nœud → Task History, filtrer sur vzdump, ouvrir le log de la VM en erreur.

  3. GUI PBS : Datastore → Summary (espace), puis Administration → Tasks.

    pvesm status                     # le stockage PBS est-il "active" ?
proxmox-backup-manager datastore list           # côté PBS
proxmox-backup-manager task list --limit 20     # côté PBS

Erreurs fréquentes

Message (extrait) Cause Action
No space left on device / datastore full Datastore PBS plein Vérifier prune et garbage collection ; lancer une GC ; ticket si toujours plein
fingerprint … does not match / certificate verify failed Certificat PBS renouvelé Datacenter → Storage → PBS → Edit → mettre à jour l'empreinte (visible dans PBS → Dashboard → Show Fingerprint)
permission check failed / authentication failure Mot de passe ou jeton API expiré, droits modifiés Corriger l'identifiant dans la définition du stockage
VM is locked (backup) Sauvegarde précédente interrompue RB-10, puis relancer
guest-fsfreeze-freeze failed / timeout Agent invité QEMU absent ou bloqué Redémarrer le service de l'agent dans la VM ; vérifier VSS sous Windows
connection refused / timed out PBS éteint ou réseau coupé Vérifier PBS et le réseau de sauvegarde

Relancer

  • Une VM : VM → Backup → Backup now, stockage PBS, mode Snapshot.
  • Tout le job : Datacenter → Backup → sélectionner le job → Run now.
vzdump 101 --storage pbs-local --mode snapshot
# côté PBS : lancer une garbage collection manuelle
proxmox-backup-manager garbage-collection start <datastore>

Ordre des tâches de maintenance PBS (à vérifier en cas de datastore plein)

  1. Sauvegardes (nuit).
  2. Prune : supprime les sauvegardes hors rétention (logique, immédiat).
  3. Garbage collection : libère réellement l'espace des blocs devenus inutiles. Un bloc n'est supprimé qu'environ 24 h après le prune.
  4. Verify : contrôle l'intégrité des sauvegardes (hebdomadaire recommandé).

Vérifications

Sauvegarde relancée en OK, statut verify vert lors du prochain contrôle, notification de succès reçue.

Pièges vus en support

  • Supprimer à la main des fichiers du datastore PBS (répertoire .chunks) corrompt toutes les sauvegardes.
  • Une GC lancée juste après un prune ne libère presque rien : c'est normal (délai de 24 h).
  • Mode Stop : la VM est arrêtée pendant la sauvegarde. Le mode Snapshot suffit dans la quasi-totalité des cas.

Quand ouvrir un ticket iTop

Datastore plein après GC, erreur de verify (chunk corrompu), échec deux nuits de suite : P2. Joindre le log de la tâche vzdump, pvesm status, une capture du Summary du datastore.

Ouvrir un ticket iTop pour RB-14 Que joindre au ticket ?

Rubrique : Proxmox Backup Server · Architecture : Toutes · Rédigé pour PVE 9.x, PBS 4.x, Ceph 19.2 · Brouillon à valider en lab avant publication · Documentation officielle : PVE · PBS