L’upgrade da Proxmox Backup Server (PBS) 3 a PBS 4 comporta anche la migrazione da Debian Bookworm a Trixie. In questa guida vedremo come eseguire l’upgrade in modo sicuro, ordinato e conforme alle best practice APT moderne.
🧰 Requisiti iniziali
Assicurati che il tuo sistema PBS sia aggiornato alla versione 3.4.2-1 o superiore:
bash
proxmox-backup-manager versions
Aggiorna PBS 3 all’ultima versione disponibile:
bash
apt update && apt dist-upgrade
Esegui un backup della configurazione:
bash
tar czf "pbs3-etc-backup-$(date -I).tar.gz" -C "/etc" "proxmox-backup"
Verifica lo spazio libero (consigliati almeno 10 GB):
bash
df -h /
🔍 Verifica compatibilità con PBS 4
Utilizza lo strumento ufficiale per controllare la compatibilità:
bash
pbs3to4 --full
Correggi eventuali problemi segnalati e rilancia il comando finché non ottieni un output pulito.
🛑 (Facoltativo) Abilita modalità manutenzione
Per evitare modifiche ai dati durante l’upgrade, puoi impostare i datastore in modalità sola lettura:
bash
proxmox-backup-manager datastore update DATASTORE-ID --maintenance-mode read-only
🧭 Aggiorna i repository APT
1. Passa da Bookworm a Trixie
bash
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
Controlla anche i file in /etc/apt/sources.list.d/ e aggiorna se necessario.
2. Aggiungi repository PBS 4 (deb822)
Enterprise
bash
cat > /etc/apt/sources.list.d/pbs-enterprise.sources << 'EOF'
Types: deb
URIs: https://enterprise.proxmox.com/debian/pbs
Suites: trixie
Components: pbs-enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF
No-subscription
bash
cat > /etc/apt/sources.list.d/proxmox.sources << 'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pbs
Suites: trixie
Components: pbs-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF
🧱 Integra il repository Debian in formato deb822
Per conformità con Debian Trixie, crea il file debian.sources:
bash
cat > /etc/apt/sources.list.d/debian.sources << 'EOF'
Types: deb
URIs: http://deb.debian.org/debian/
Suites: trixie trixie-updates
Components: main contrib non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: http://security.debian.org/debian-security/
Suites: trixie-security
Components: main contrib non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
EOF
Svuota il vecchio sources.list:
bash
truncate -s 0 /etc/apt/sources.list
Oppure rimuovilo del tutto:
bash
rm /etc/apt/sources.list
Verifica la configurazione:
bash
apt update && apt policy
⬆️ Esegui l’upgrade a PBS 4
bash
apt update && apt dist-upgrade
Durante l’upgrade:
- Premi
q per uscire da apt-listchanges
- Mantieni le versioni locali per
/etc/issue e /etc/default/grub
- Per
/etc/ssh/sshd_config, accetta la versione del maintainer se non hai modifiche personalizzate
🔁 Riavvia il sistema
bash
systemctl reboot
✅ Verifiche post-upgrade
Controlla che i servizi PBS siano attivi:
bash
systemctl status proxmox-backup-proxy.service
systemctl status proxmox-backup.service
Disabilita la modalità manutenzione:
bash
proxmox-backup-manager datastore update DATASTORE-ID --delete maintenance-mode
(Facoltativo) Modernizza tutti i repository:
bash
apt modernize-sources
🧪 Conclusione
L’upgrade a PBS 4 è un’operazione delicata ma gestibile con metodo. L’integrazione dei repository in formato deb822 garantisce coerenza e compatibilità futura. Se operi in ambienti clusterizzati, considera l’automazione dei controlli EFI, backup e verifica dei repository.
