Mettre à jour Proxmox Backup Server 3 vers la version 4

En août 2025, avec la sortie de Debian Trixie (13), Proxmox Backup Server (PBS) passe la quatrième.

De la même manière que pour Proxmox VE (article j.hommet.net ), une commande spécifique (pbs3to4) vous permettra de préparer la mise à niveau de votre PBS. Avant de mettre à jour votre machine, il est important de suivre certaines bonnes pratiques. Comme toujours, voici ma procédure :

Sauvegarde des données et préparation du serveur PBS
Lecture des journaux des modifications
Mise à jour de la version N-1 (PBS 3)
Mise à jour de la version N (PBS 4)
Tests de bon fonctionnement

Si possible, effectuez un test de mise à jour sur une machine dédié, non sensible et destructible. De plus, effectuez les manipulations suivantes avec le compte root plutôt qu’un compte qui dispose des droits sudo. L’utilisateur root a un réel droit sur l’intégralité du système, ce qui est nécessaire lors de ce genre de manipulation.

Sauvegarde des données et préparation du serveur PBS#

Sauvegarder les données du serveur de sauvegarde, c’est toujours un concept qui me fera sourire. Ce n’est d’ailleurs pas la chose la plus simple, compte tenu de la quantité de données et de toutes les contraintes qui y sont liées.

Avec PBS 3, vous pouvez répliquer les données du serveur de sauvegarde vers un autre PBS. Cette procédure est simple à mettre en œuvre et est conseillée (si vous pouvez vous en donner les moyens).

N’oubliez pas de documenter la procédure et de tenir un journal des tests de restauration réalisés, en notant les succès ainsi que les échecs, accompagnés d’une description détaillée (surtout pour les échecs, qui vous donneront une plus-value technique si le problème revient ou si vous avez besoin de partager votre expérience).

Aussi, dans un serveur Proxmox Backup Server, il est utile de sauvegarder les fichiers contenus dans le dossier “/etc/pbs/”. À l’intérieur se trouvent les clés publiques/privées, les certificats, les comptes utilisateurs locaux, etc. avec la commande tar -czvf "/etc/pbs/pbs_backup_$(date +'%Y%m%d').tar.gz" /etc/pbs.

De plus, prenez le temps de vérifier les sauvegardes de vos machines. Dans le datastore, sélectionnez “content”, naviguez dans le “namespace” où sont les sauvegardes et assurez-vous que tous les fichiers sont validés, avec le statut “OK”. Ce résultat est obtenu suite à un “verify job” qui est, en principe, lancé périodiquement et a déjà fait le travail.

Lecture des journaux des modifications#

Vous trouverez l’ensemble des changements sur le wiki officiel de Proxmox Backup Server, à cette adresse .

Roadmap - Proxmox Backup ServerProxmox Backup ServerIl est toujours fascinant de suivre ces évolutions, surtout lorsqu’elles concernent les outils de stockage. Avec PBS 4.0, OpenZFS a été mis à jour vers la version 2.3.3, ce qui a suscité de nombreuses discussions au début de 2025 en raison des nombreux correctifs intégrés au noyau Linux. La grande nouveauté pour ZFS est la possibilité d’étendre une grappe RAIDZ sans devoir la recréer.

Une autre nouveauté importante est la compatibilité avec le stockage de type S3, permettant désormais de stocker vos sauvegardes et instantanés de VM sur une cible S3.

Mise à jour de la version N-1 (PBS 3)#

Lorsque vous utilisez PBS dans un environnement Proxmox, il est fortement recommandé de désactiver toutes les tâches de sauvegarde de vos VM dans PVE. En effet, la mise à jour nécessitera un redémarrage de la machine, bloquant l’accès au stockage PBS. Sans cet accès, les VM ne pourront pas être sauvegardées. Il est inutile de laisser ces tâches s’exécuter en arrière-plan, car elles échoueront et généreront un trafic réseau inutile.

Un mode maintenance est activable sur demande, en saisissant la commande proxmox-backup-manager datastore update <nom_datastore> --maintenance-mode read-only. Pour trouver le nom des datastore, vous pouvez saisir proxmox-backup-manager datastore list. Pour ma part, voici ce que j’ai saisi :

$ proxmox-backup-manager datastore list
┌───────────┬──────────────────────────┬─────────┐
│ name      │ path                     │ comment │
╞═══════════╪══════════════════════════╪═════════╡
│ pbs-disk1 │ /mnt/datastore/pbs-disk1 │         │
└───────────┴──────────────────────────┴─────────┘
$
$ proxmox-backup-manager datastore update pbs-disk1 --maintenance-mode read-only
$
$ proxmox-backup-manager datastore show pbs-disk1
┌───────────────────┬──────────────────────────┐
│ Name              │ Value                    │
╞═══════════════════╪══════════════════════════╡
│ name              │ pbs-disk1                │
├───────────────────┼──────────────────────────┤
│ path              │ /mnt/datastore/pbs-disk1 │
├───────────────────┼──────────────────────────┤
│ gc-schedule       │ 2:00                     │
├───────────────────┼──────────────────────────┤
│ maintenance-mode  │ read-only                │
├───────────────────┼──────────────────────────┤
│ notification-mode │ notification-system      │
└───────────────────┴──────────────────────────┘

Avant de passer à une version supérieure, assurez-vous que toutes les dernières mises à jour de la version actuelle sont installées. Cette étape est cruciale, parce qu’elle met à niveau vos machines et garantit que vous disposez des prérequis nécessaires pour une transition fluide vers la version supérieure.

Souvent, une mise à jour du noyau est poussée, un redémarrage de la machine est alors nécessaire avant d’effectuer la mise à niveau vers une autre version de PBS.

Mise à jour de la version N (PBS 4)#

La commande pbs3to4 est un outil vous permettant de valider les prérequis pour passer d’une version majeure à une autre.

Assurez-vous d’avoir au moins 10 Gb d’espace libre pour le téléchargement et la décompression des nouveaux paquets. Vous devez être dans la version “3.4.2-1” pour passer à PBS 4. Le serveur PBS que j’utilise dans mon lab’ est une machine virtuelle. Voici le retour de la commande pbs3to4 :

root@durango:~# pbs3to4
= CHECKING VERSION INFORMATION FOR PBS PACKAGES =

INFO: Checking for package updates..
PASS: all packages up-to-date
INFO: Checking proxmox backup server package version..
PASS: 'proxmox-backup' has version >= 3.4.0
INFO: Check running kernel version..
PASS: running kernel '6.8.12-12-pve' is considered suitable for upgrade.

= MISCELLANEOUS CHECKS =

INFO: Checking PBS daemon services..
PASS: systemd unit 'proxmox-backup.service' is in state 'active'
PASS: systemd unit 'proxmox-backup-proxy.service' is in state 'active'
INFO: Checking for supported & active NTP service..
PASS: Detected active time synchronisation unit
INFO: Checking for package repository suite mismatches..
PASS: found no suite mismatch
INFO: Checking bootloader configuration...
FAIL: systemd-boot meta-package installed. This will cause problems on upgrades of other boot-related packages.
Remove the 'systemd-boot' package.
See https://pbs.proxmox.com/wiki/Upgrade_from_3_to_4#sd-boot-warning for more information.
SKIP: could not get dkms status

= SUMMARY =

TOTAL:     9
PASSED:    7
SKIPPED:   1
NOTICE:    0
FAILURES:  1

ATTENTION: Please check the output for detailed information!
Try to solve the problems one at a time and rerun this checklist tool again.

Le problème le plus flagrant concerne le paquet systemd-boot :

FAIL: systemd-boot meta-package installed. This will cause problems on upgrades of other boot-related packages.
Remove the 'systemd-boot' package.

Un rapide apt remove systemd-boot et le tour est joué. Maintenant, le serveur semble prêt :

# pbs3to4
= CHECKING VERSION INFORMATION FOR PBS PACKAGES =

INFO: Checking for package updates..
PASS: all packages up-to-date
INFO: Checking proxmox backup server package version..
PASS: 'proxmox-backup' has version >= 3.4.0
INFO: Check running kernel version..
PASS: running kernel '6.8.12-12-pve' is considered suitable for upgrade.

= MISCELLANEOUS CHECKS =

INFO: Checking PBS daemon services..
PASS: systemd unit 'proxmox-backup.service' is in state 'active'
PASS: systemd unit 'proxmox-backup-proxy.service' is in state 'active'
INFO: Checking for supported & active NTP service..
PASS: Detected active time synchronisation unit
INFO: Checking for package repository suite mismatches..
PASS: found no suite mismatch
INFO: Checking bootloader configuration...
PASS: bootloader packages installed correctly
SKIP: could not get dkms status

= SUMMARY =

TOTAL:     9
PASSED:    8
SKIPPED:   1
NOTICE:    0

Avec la commande sed, nous allons changer le nom de la version de Debian : sed -i 's/bookworm/trixie/g' /etc/apt/sources.list. Le 12/08/2025, il n’y a pas la commande apt modernize-sources. Vous pourrez mettre à niveau le fichier de sources a postériori.

# apt update
Get:1 http://ftp.fr.debian.org/debian trixie InRelease [138 kB]
Get:2 http://security.debian.org trixie-security InRelease [43.4 kB]
Get:3 http://download.proxmox.com/debian/pbs trixie InRelease [2,785 B]
Get:4 http://ftp.fr.debian.org/debian trixie-updates InRelease [47.1 kB]
Get:5 http://download.proxmox.com/debian/pbs trixie/pbs-no-subscription amd64 Packages [71.7 kB]
Get:6 http://security.debian.org trixie-security/main amd64 Packages [5,304 B]
Get:7 http://security.debian.org trixie-security/main Translation-en [6,724 B]
Get:8 http://ftp.fr.debian.org/debian trixie/main amd64 Packages [9,668 kB]
Get:9 http://ftp.fr.debian.org/debian trixie/main Translation-en [6,484 kB]
Get:10 http://ftp.fr.debian.org/debian trixie/contrib amd64 Packages [53.8 kB]
Get:11 http://ftp.fr.debian.org/debian trixie/contrib Translation-en [49.6 kB]
Get:12 http://ftp.fr.debian.org/debian trixie-updates/main amd64 Packages [2,432 B]
Get:13 http://ftp.fr.debian.org/debian trixie-updates/main Translation-en [396 B]
Fetched 16.6 MB in 2s (9,658 kB/s)
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
357 packages can be upgraded. Run 'apt list --upgradable' to see them.

La commande apt dist-upgrade effectuera les mises à jour des paquets. L’opération durera environ une vingtaine de minutes, tout dépend de votre matériel. Pendant la mise à jour, des questions seront posées quant aux services à redémarrer automatiquement ; je vous conseille de répondre “No”. En effet, il n’est pas utile de redémarrer les services à chaud, durant la mise à jour de PBS, puisque nous devrons dans tous les cas redémarrer le serveur. D’autres questions seront posées pour mettre à jour les fichiers /etc/issue ou encore /etc/ssh/sshd_config (attention à vos modifications).

Tests de bon fonctionnement#

Lorsque vous avez redémarré votre machine, essayez d’accéder à votre serveur PBS. C’est le premier test, est-ce que le serveur a redémarré et est-il en état de marche ?

Serveur redémarré, accessible, ne reste plus qu’à relancer les sauvegardes.

Et maintenant ?#

Effectuez, en SSH, la commande apt autoremove pour supprimer les résidus (notamment les noyaux obsolètes).

Stockage de type ZFS#

Si vos datastore sont de type ZFS, le passage de PBS 3 à 4 met à jour zfs en 2.3.3. Cette version apporte son lot d’amélioration et aussi de nouvelles fonctionnalités. Quand vous êtes connecté à l’interface web de PBS, sélectionnez le stockage ZFS et cliquez sur le bouton “Details” - vous verrez qu’une action est en attente sur le pool, pour le mettre à jour.

Ainsi, connectez-vous en SSH sur ce PBS, listez les stockages ZFS, puis lancez la commande zpool upgrade <nom_pool_zfs> (en remplaçant évidemment le nom par le vôtre). L’opération ne semble pas destructive (testé sur six hôtes pbs différents, avec des stockages ZFS de toute taille, sur des disques mécaniques et flash, plusieurs fonctions sont ajoutées pour optimiser le stockage, surtout le “fast_dedup”.

Compléments#

Avec Debian 13, APT passe en version 3 et dispose d’un nouveau formalisme pour les fichiers sources.list (Merci L.G. pour l’info’ !). Debian dispose d’une page pour expliquer les changements :

SourcesList - Debian WikiDebian WikiJ’ai lancé la commande apt modernize-sources et les fichiers se sont mis à jour :

# apt modernize-sources
The following files need modernizing:
  - /etc/apt/sources.list
  - /etc/apt/sources.list.d/pbs-enterprise.list

Modernizing will replace .list files with the new .sources format,
add Signed-By values where they can be determined automatically,
and save the old files into .list.bak files.

This command supports the 'signed-by' and 'trusted' options. If you
have specified other options inside [] brackets, please transfer them
manually to the output files; see sources.list(5) for a mapping.

For a simulation, respond N in the following prompt.
Rewrite 2 sources? [Y/n]
Modernizing /etc/apt/sources.list...
- Writing /etc/apt/sources.list.d/debian.sources
- Writing /etc/apt/sources.list.d/proxmox.sources

Modernizing /etc/apt/sources.list.d/pbs-enterprise.list...

# cat /etc/apt/sources.list.d/proxmox.sources
# Modernized from /etc/apt/sources.list
Types: deb
URIs: http://download.proxmox.com/debian/pbs/
Suites: trixie
Components: pbs-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Si vous n’utilisez pas les dépôts enterprise de Proxmox Backup Server, désactivez-les depuis l’interface web, ou en déplaçant/renommant le fichier “/etc/apt/sources.list.d/pbs-enterprise.sources” en “/etc/apt/sources.list.d/pbs-enterprise.sources.bak”, suivi de la commande apt update pour prendre en compte les changements.

N’oubliez pas d’enlever le mode maintenance, avec la commande proxmox-backup-manager datastore update <nom_datastore> --delete maintenance-mode, et/ou de réactiver les tâches de sauvegarde depuis vos serveurs Proxmox.

Source