Restauration de fichiers depuis PBS (hôtes et VM)

Restauration de fichiers depuis PBS (hôtes et VM)

Objectif

Restaurer des fichiers ou répertoires depuis les sauvegardes PBS sans restaurer une machine complète.

Cette procédure s’applique :

• aux hôtes (ex : saturne3, eole3)
• aux fichiers systèmes (/etc, /root, etc.)
• aux cas de restauration ponctuelle

---

Méthodes disponibles

Deux méthodes principales :

• CLI (proxmox-backup-client) → méthode recommandée
• Interface web PBS → méthode simple mais manuelle

---

Exemple de restauration depuis saturne3

Méthode 1 : Restauration depuis la console (recommandé)

Pré-requis

export PBS_PASSWORD="$(cat /root/.pbs_token_saturne3)"
export PBS_FINGERPRINT="79:e2:df:a6:33:56:1b:22:63:b3:31:a4:09:63:de:c4:50:e3:eb:d5:87:a0:14:f0:c8:9c:fa:ed:df:b0:1a:39"

---

Étape 1 : Lister les snapshots

proxmox-backup-client snapshots \
  --repository 'saturne@pbs@pbs!saturne3@pbs4.ajlsm.com:pbs-saturne'

---

Étape 2 : Explorer un backup

proxmox-backup-client catalog shell \
  host/Saturne3/2026-04-20T09:10:01Z \
  etc.pxar \
  --repository 'saturne@pbs@pbs!saturne3@pbs4.ajlsm.com:pbs-saturne'

Commandes disponibles :

ls
cd
cat

Exemple :

cd etc/network
cat interfaces

---

Étape 3 : Restaurer un fichier

Exemple : restauration de /etc/network/interfaces

proxmox-backup-client restore \
  host/Saturne3/2026-04-20T09:10:01Z \
  etc.pxar \
  /tmp/restore \
  --repository 'saturne@pbs@pbs!saturne3@pbs4.ajlsm.com:pbs-saturne' \
  --include /etc/network/interfaces

---

Résultat

Fichier restauré dans :

/tmp/restore/etc/network/interfaces

Étape 4 : Remise en place

cp /tmp/restore/etc/network/interfaces /etc/network/interfaces

---

Bonnes pratiques

• Toujours restaurer dans un dossier temporaire (/tmp)
• Vérifier le contenu avant écrasement
• Ne jamais restaurer directement en production sans contrôle

---

Cas d’usage courants

Cas 1 : restauration d’un fichier supprimé

Exemple : /etc/hosts

proxmox-backup-client restore \
  host/Saturne3/<snapshot> \
  etc.pxar \
  /tmp/r \
  --include /etc/hosts

---

Cas 2 : restauration d’un répertoire

Exemple : /etc/ssh

proxmox-backup-client restore \
  host/Saturne3/<snapshot> \
  etc.pxar \
  /tmp/r \
  --include /etc/ssh

---

Cas 3 : restauration complète d’un archive

proxmox-backup-client restore \
  host/Saturne3/<snapshot> \
  etc.pxar \
  /tmp/full-etc

---

Méthode 2 : Restauration depuis l’interface PBS

Accès

Datastore → pbs-saturne → Content

---

Étapes

1. Cliquer sur :

 host/Saturne3

1. Choisir un snapshot
2. Cliquer sur :

 etc.pxar

---

Navigation

Interface graphique permettant :

• navigation dans les dossiers
• visualisation des fichiers
• sélection des éléments

---

Téléchargement

• Sélectionner un fichier
• Cliquer sur "Download"

---

Restauration vers saturne3

1. Télécharger le fichier sur le poste local 2. Envoyer vers saturne3 :

scp fichier root@saturne3:/tmp/

3. Copier vers l’emplacement final :

cp /tmp/fichier /etc/...

---

Comparatif des méthodes

Méthode	Avantages	Inconvénients
CLI	rapide, scriptable, direct	nécessite ligne de commande
Interface PBS	simple, visuel	manuel, nécessite transfert

---

Recommandations

• Utiliser l’interface PBS pour localiser les fichiers
• Utiliser la CLI pour la restauration réelle
• Éviter les restaurations directes en production sans validation
• Documenter les chemins critiques (/etc, /etc/pve, /root)

---

Points de vigilance

• /etc/pve est un système spécial (pmxcfs)
• Ne pas restaurer en direct sans précaution
• Toujours vérifier les permissions après restauration
• Vérifier la cohérence des services après restauration

---

Conclusion

PBS permet une restauration fine des fichiers :

• sans restaurer une VM complète
• sans interruption de service
• avec une grande précision

La méthode CLI est à privilégier pour un usage professionnel.

Exemple de restauration depuis eole3

Pré-requis

export PBS_PASSWORD="$(cat /root/.pbs_token_eole3)"
export PBS_FINGERPRINT="79:e2:df:a6:33:56:1b:22:63:b3:31:a4:09:63:de:c4:50:e3:eb:d5:87:a0:14:f0:c8:9c:fa:ed:df:b0:1a:39"

---

Étape 1 : Lister les snapshots

proxmox-backup-client snapshots \
  --repository 'saturne@pbs@pbs!eole3@pbs4.ajlsm.com:pbs-saturne'

---

Exemple de résultat

host/eole3/2026-04-20T02:30:01Z

---

Étape 2 : Explorer le contenu

proxmox-backup-client catalog shell \
  host/eole3/2026-04-20T02:30:01Z \
  etc.pxar \
  --repository 'saturne@pbs@pbs!eole3@pbs4.ajlsm.com:pbs-saturne'

---

Exemple d’utilisation

cd etc
ls
cd ssh
cat sshd_config

---

Étape 3 : Restaurer un fichier

Exemple : restauration de /etc/ssh/sshd_config

proxmox-backup-client restore \
  host/eole3/2026-04-20T02:30:01Z \
  etc.pxar \
  /tmp/restore \
  --repository 'saturne@pbs@pbs!eole3@pbs4.ajlsm.com:pbs-saturne' \
  --include /etc/ssh/sshd_config

---

Résultat

Fichier restauré dans :

/tmp/restore/etc/ssh/sshd_config

---

Étape 4 : Remise en place

cp /tmp/restore/etc/ssh/sshd_config /etc/ssh/sshd_config

---

Cas spécifique eole3

eole3 étant un serveur de données (SFTP/stockage), les restaurations fréquentes concernent :

• /var/lib/sftpgo
• /usr/local (scripts)
• /var/log

---

Exemple : restauration d’un fichier SFTPGo

proxmox-backup-client restore \
  host/eole3/2026-04-20T02:30:01Z \
  sftpgo_lib.pxar \
  /tmp/restore \
  --repository 'saturne@pbs@pbs!eole3@pbs4.ajlsm.com:pbs-saturne' \
  --include /var/lib/sftpgo/data/users.json

---

Exemple : restauration d’un script

proxmox-backup-client restore \
  host/eole3/2026-04-20T02:30:01Z \
  usr_local.pxar \
  /tmp/restore \
  --repository 'saturne@pbs@pbs!eole3@pbs4.ajlsm.com:pbs-saturne' \
  --include /usr/local/sbin/backup_pbs_eole3.sh

---

Bonnes pratiques spécifiques

• Toujours vérifier les droits après restauration
• Attention aux services dépendants (sftpgo, scripts cron)
• Tester avant remise en production