🚀 Upgrade Proxmox Backup Server 3 → 4: Guida Tecnica Completa

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.

🚀 Come eliminare il pop‑up “Nessuna sottoscrizione” su Proxmox 

🎯 Perché appare quel messaggio?

Dopo aver installato Proxmox in modalità “No Subscription”, la GUI mostra un pop‑up:

“Nessuna sottoscrizione”

Questo avviso blocca l’accesso agli aggiornamenti e al supporto. La soluzione consiste nel modificare il file JavaScript che controlla lo stato della sottoscrizione.

🛠️ Procedura passo‑passo

1. Apri la shell dalla Web‑GUI di Proxmox Esegui: ssh root@<IP-del-tuo-proxmox>

2. Vai alla cartella contenente lo script Esegui: cd /usr/share/javascript/proxmox-widget-toolkit

3. Crea un backup del file originale Esegui: cp proxmoxlib.js proxmoxlib.js.bak

4. Modifica il file con l’editor a tua scelta Esegui: nano proxmoxlib.js oppure vim proxmoxlib.js

5. Trova la riga che verifica lo stato della sottoscrizione Cerca: if (data.status !== 'Active') {

6. Sostituisci l’intero blocco con un “falso” costante Modifica con: if (false) {

7. Salva ed esci dall’editor In nano: Ctrl+O, Enter, Ctrl+X

8. Riavvia il servizio che gestisce la GUI Esegui: systemctl restart pveproxy.service

⚠️ Se stai usando Proxmox Backup Server (PBS) o Mail Gateway, usa uno dei seguenti comandi:

  • PBS → systemctl restart proxmox-backup-proxy.service
  • Mail Gateway → systemctl restart pgmproxy.service

🔁 Cosa succede dopo?

Ogni volta che installi un aggiornamento di Proxmox VE (incluso l’interfaccia GUI), il file JavaScript viene sovrascritto. Dovrai quindi ripetere la procedura sopra descritta dopo ogni upgrade.