Guida Passo per Passo: Aggiornamento da Proxmox VE 8 a 9

Introduzione

Proxmox VE 9.x presenta nuove funzionalità importanti. Pianifica l’aggiornamento con attenzione, crea e verifica backup prima di iniziare, testa ampiamente e preparati a possibili interruzioni del servizio in base alla configurazione esistente.

Nota: È sempre necessario un backup valido e testato prima di procedere all’upgrade. Testa il backup in un ambiente di prova.
Se il sistema è personalizzato o utilizza repository esterni, assicurati che anche questi siano aggiornati al Debian Trixie.

Opzioni per l’aggiornamento

Nuova installazione su hardware nuovo (ripristino delle VM da backup)
Aggiornamento in-place tramite apt (passo per passo)

Passi per l’aggiornamento in-place

Prerequisiti

Aggiorna a Proxmox VE 8.4 su tutti i nodi.
Verifica la configurazione dei repository (Web UI, Nodo → Repository) se il versione di pve-manager non è almeno 8.4.1.
Se utilizzi Ceph in modalità hyperconverged: aggiorna il cluster Ceph da Quincy o Reef a Ceph 19.2 Squid prima di procedere all’upgrade a Proxmox VE 9.0 (vedi le guide dedicate).
Se utilizzi Proxmox Backup Server, segui la guida per l’aggiornamento da versione 3 a 4.
Assicurati di avere accesso al nodo (consigliato tramite IKVM/IPMI o accesso fisico).
Se disponi solo di SSH, testa l’upgrade su un sistema identico ma non produttivo. Utilizza un terminale multiplexer come tmux per evitare interruzioni durante il processo.
Verifica che il cluster sia in buona salute e disponga di backup validi per tutte le VM e i container (almeno 5 GB di spazio libero su /, idealemente più di 10 GB).
Controlla i problemi noti all’upgrade.

Passaggi dettagliati

1. Utilizza lo script pve8to9 per verificare le condizioni
Esegui:

pve8to9 --full

Verifica che il sistema non presenti errori critici e ripeti l’esecuzione dopo ogni correzione.

2. Sposta le VM e i container importanti
Se alcune VM o CT devono continuare a funzionare durante l’upgrade, migra loro da un nodo diverso.

Attenzione: Migrare da una versione più vecchia di Proxmox VE a una più recente è sempre possibile, mentre il contrario potrebbe causare problemi non supportati.

3. Aggiorna i repository APT

Verifica che il sistema utilizzi le ultime versioni di Proxmox VE 8.4:

apt update && apt dist-upgrade && pveversion

Assicurati che la versione sia almeno 8.4.1.

Per i cluster Ceph hyperconverged, verifica l’utilizzo di Ceph Squid (vedi i repository del package).

4. Aggiorna i repository Debian a Trixie
Modifica /etc/apt/sources.list e /etc/apt/sources.list.d/pve-enterprise.list:

sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list

Rimuovi eventuali repository specifici per Bookworm e verifica che i nuovi repository siano corretti.

5. Aggiungi il repository Proxmox VE 9

Per l’enterprise repository:

cat > /etc/apt/sources.list.d/pve-enterprise.sources << EOF
Types: deb
URIs: https://enterprise.proxmox.com/debian/pve
Suites: trixie
Components: pve-enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Per il repository senza sottoscrizione:

cat > /etc/apt/sources.list.d/proxmox.sources << EOF
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Aggiungere dopo il riavvio il nuovo Debian.sources

Decommentare o eliminare in apt sources.list

Types: deb deb-src
URIs: http://deb.debian.org/debian/
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb deb-src
URIs: http://security.debian.org/debian-security/
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Verifica con apt update e apt policy.

6. Aggiorna il repository Ceph

Per i cluster Ceph, sostituisci eventuali repository di ceph.com con quelli di proxmox.com.
Aggiungi il repository enterprise o no-subscription per Ceph Squid:

cat > /etc/apt/sources.list.d/ceph.sources << EOF
Types: deb
URIs: https://enterprise.proxmox.com/debian/ceph-squid
Suites: trixie
Components: enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Verifica con apt update e rimuovi i repository vecchi.

7. Aggiorna l’indice dei pacchetti

apt update

Assicurati che non siano segnalati errori.

8. Esegui l’upgrade a Debian Trixie e Proxmox VE 9.0

Inizia con:

apt dist-upgrade

Durante il processo, rispondi alle richieste di modifiche ai file di configurazione e riavvio dei servizi. Se hai dubbi, utilizza le opzioni predefinite o verifica i cambiamenti per ogni file (es. /etc/issue, /etc/lvm/lvm.conf).

9. Controlla il risultato e riavvia con il nuovo kernel
Se l’upgrade ha successo:

Verifica lo script pve8to9.
Riavvia il sistema per utilizzare il kernel aggiornato.

Dopo l’aggiornamento a Proxmox VE 9

Ripulisci la cache del browser e forza il reload della UI Web (CTRL+SHIFT+R o ⌘+Alt+R su macOS).
Per i cluster: verificare che tutti i nodi siano aggiornati. Se no, ripeti l’upgrade su un altro nodo.
Deprecato: Le regole HA sono sostituite da HA rules. Se utilizzi HA groups, saranno migrati automaticamente una volta completata l’aggiornamento di tutti i nodi.
Opzionale: modernizza i repository APT con apt modernize-sources.

Problemi noti e troubleshooting

Pacchetto proxmox-ve troppo vecchio: Verifica che i repository siano configurati correttamente per Proxmox VE 8.x, esegui apt update && apt dist-upgrade.
Autoactivation su LVM/LVM-thin storage: Disattiva l’autoactivation per le VM con il comando /usr/share/pve-manager/migrations/pve-lvm-disable-autoactivation.
Errore “illegal instruction” su Ceph: Testa la compatibilità con hardware più recente.
Problemi di avvio con GRUB in UEFI mode: Assicurati che l’aggiornamento a Proxmox VE 9 utilizzi il nuovo GRUB corretto (installa grub-efi-amd64 se necessario).
Errore cgroup V1: Le VM con systemd <230 non saranno supportate. Migra su versioni più recenti del sistema operativo container.