Come aggiornare Proxmox VE 7 a Proxmox VE 8

Questa guida descrive l'aggiornamento in-place di un nodo Proxmox VE 7 a Proxmox VE 8 con apt. L'aggiornamento porta il sistema da Debian 11 Bullseye a Debian 12 Bookworm e sostituisce il kernel 5.15 con uno più recente. Pianificate un periodo di inattività: il nodo deve essere riavviato almeno una volta e, di solito, due.

Prima di iniziare

Requisiti

Verificate quanto segue prima di toccare qualsiasi repository:

• tutti i nodi eseguono gli ultimi pacchetti di Proxmox VE 7.4 (pve-manager 7.4-15 o successivo);
• almeno 5 GB di spazio libero sul file system root;
• il cluster è in buone condizioni, se il nodo fa parte di un cluster;
• avete accesso al server indipendente dalla sua rete, ad esempio tramite IP-KVM;
• esiste un backup valido e testato di tutte le macchine virtuali e di tutti i container.

Verificate lo spazio libero sul file system root:

df -h /

Come connettersi al nodo

Connettetevi tramite SSH o IP-KVM. Con SSH, avviate una sessione tmux in modo che l'aggiornamento prosegua se la connessione cade:

apt update
apt install tmux
tmux new -s upgrade

Se la connessione viene persa, riconnettetevi e tornate alla sessione:

tmux attach -t upgrade

L'opzione più sicura è IP-KVM, perché continua a funzionare anche se la rete del nodo non si attiva dopo il riavvio. Per connettersi a un server dedicato tramite IP-KVM, consultate Connessione a IDRAC KVM oppure Guida all'accesso IP-KVM tramite OpenVPN (server DC2, DC3).

Macchine virtuali e container sul nodo

Arrestate le macchine virtuali e i container sul nodo oppure migrateli su un altro nodo se devono restare in esecuzione. La migrazione da una versione precedente di Proxmox VE a una più recente è supportata. La migrazione da una versione più recente a una precedente non è supportata.

Passaggio 1. Aggiornare Proxmox VE 7 alla versione 7.4

Lo strumento di verifica pve7to8 e un percorso di aggiornamento sicuro sono disponibili solo con gli ultimi pacchetti 7.4. Potete installare gli aggiornamenti nell'interfaccia web o dalla riga di comando.

Configurare i repository

Aprite il nodo nell'interfaccia web e andate in Updates → Repositories.

Se non avete un abbonamento a pagamento, selezionate il repository pve-enterprise e fate clic su Disable. Questo repository richiede una chiave di abbonamento.

Fate clic su Add, selezionate No-Subscription e fate clic su Add nella finestra di dialogo.

Installare gli aggiornamenti

Andate in Updates e fate clic su Refresh. Attendete che l'elenco dei pacchetti sia aggiornato.

Fate clic su Upgrade. Si apre una finestra di terminale. Quando viene chiesto se continuare, digitate Y e premete Invio.

Attendete il termine del processo e non chiudete la finestra. Alla fine, l'output chiede di riavviare il nodo.

Lo stesso aggiornamento dalla riga di comando. Senza abbonamento a pagamento, disattivate prima il repository enterprise e aggiungete quello no-subscription, come nell'interfaccia web qui sopra:

sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list
echo "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

Quindi installate gli aggiornamenti:

apt update
apt dist-upgrade

deb http://archive.debian.org/debian bullseye main contrib
deb http://archive.debian.org/debian-security bullseye-security main contrib

Queste righe servono solo per completare il Passaggio 1. Nel Passaggio 3, sostituitele con le righe Bookworm mostrate lì invece di eseguire sed.

Riavviare e verificare la versione

Riavviate il nodo:

reboot

Dopo l'avvio del nodo, aggiornate la pagina del browser e controllate la versione in Summary del nodo, oppure eseguite:

pveversion

L'output deve mostrare 7.4-15 o successivo.

Passaggio 2. Eseguire lo strumento di verifica pve7to8

Proxmox VE 7.4 include lo script pve7to8. Esso si limita a controllare il sistema e a segnalare i problemi; non modifica nulla. Eseguitelo con tutti i controlli abilitati:

pve7to8 --full

Esaminate il risultato:

• le voci FAIL devono essere risolte prima dell'aggiornamento;
• le voci WARN devono essere lette e valutate, anche se non bloccano l'aggiornamento;
• dopo ogni correzione, eseguite di nuovo lo script per confermare che il problema sia risolto.

Passaggio 3. Passare i repository a Bookworm

Repository Debian

Sostituite Bullseye con Bookworm nell'elenco delle sorgenti principale:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list

Se nel Passaggio 1 siete passati a archive.debian.org, sed farebbe puntare le righe a un percorso Bookworm che non esiste nell'archivio. Sostituite invece il contenuto di /etc/apt/sources.list con le righe standard di Debian 12:

deb http://deb.debian.org/debian bookworm main contrib
deb http://deb.debian.org/debian bookworm-updates main contrib
deb http://security.debian.org/debian-security bookworm-security main contrib

Poi verificate che non rimangano voci Bullseye in nessun file:

grep -r bullseye /etc/apt/sources.list /etc/apt/sources.list.d/

Se il comando trova delle righe, aggiornatele a Bookworm o commentatele con #. Rimuovete eventuali righe di backports: l'aggiornamento non è stato testato con pacchetti da backports.

Verificate inoltre che non vi siano pacchetti bloccati (held) o installati a metà. Entrambi i comandi devono restituire un output vuoto:

apt-mark showhold
dpkg --audit

Repository Proxmox VE

Il nome del file del repository dipende da come è stato aggiunto il repository. Elencate prima i file:

ls /etc/apt/sources.list.d/

Senza abbonamento, aggiornate il file che contiene la riga pve-no-subscription. Su un sistema installato da ISO, di solito è pve-install-repo.list:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list.d/pve-install-repo.list

La riga corretta per Proxmox VE 8 senza abbonamento è:

deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

Su alcuni sistemi la riga contiene anche [arch=amd64] dopo deb. Va bene, mantenetelo.

Assicuratevi che il repository enterprise sia disattivato: se esiste pve-enterprise.list, la sua riga deve essere commentata con #, come dopo averlo disattivato nel Passaggio 1.

Con un abbonamento a pagamento, scrivete il repository enterprise e assicuratevi che non rimanga attiva alcuna riga pve-no-subscription in altri file:

echo "deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise" > /etc/apt/sources.list.d/pve-enterprise.list

Repository Ceph

Saltate questa parte se Ceph non è installato sul nodo.

Con abbonamento a pagamento:

echo "deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise" > /etc/apt/sources.list.d/ceph.list

Senza abbonamento:

echo "deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription" > /etc/apt/sources.list.d/ceph.list

Aggiornare l'indice dei pacchetti

apt update

L'output non deve contenere errori. Ogni riga deve puntare a bookworm.

Passaggio 4. Aggiornare il sistema a Proxmox VE 8

Avviate l'aggiornamento:

apt dist-upgrade

La durata dipende dalla velocità del disco root: pochi minuti su SSD, fino a un'ora o più su un HDD lento.

Richieste durante l'aggiornamento

Se all'inizio si apre una pagina con le note di rilascio, premete q per chiuderla e continuate.

Quando viene chiesto se riavviare automaticamente i servizi durante gli aggiornamenti dei pacchetti, selezionate Yes con i tasti freccia e premete Invio.

Richieste sui file di configurazione

Durante l'aggiornamento, apt chiede come procedere con i file di configurazione modificati sia da voi sia dal pacchetto. Premete D per vedere la differenza prima di rispondere. Risposte consigliate per i file più comuni:

• /etc/issue: mantenete la vostra versione (N). Proxmox VE rigenera questo file all'avvio e influisce solo sulla schermata di login;
• /etc/lvm/lvm.conf: installate la versione del maintainer del pacchetto (Y) se non avete modificato il file voi stessi;
• /etc/apt/sources.list.d/pve-enterprise.list: se apt chiede di questo file, mantenete la vostra versione (N), altrimenti apt sovrascrive il repository configurato nel Passaggio 3;
• /etc/ssh/sshd_config: se non avete modificato il file, installate la versione del maintainer (Y), che sostituisce l'opzione obsoleta ChallengeResponseAuthentication con KbdInteractiveAuthentication. Se avete modificato voi stessi le impostazioni SSH, confrontate attentamente i file;
• /etc/default/grub: questa richiesta compare di solito solo se avete modificato il file, ad esempio per aggiungere parametri del kernel. Controllate la differenza; in caso di dubbio, mantenete la vostra versione (N).

[ -d /sys/firmware/efi ] && apt install grub-efi-amd64

Eseguite questo comando sui sistemi UEFI che si avviano con GRUB, che è l'impostazione predefinita per le installazioni dall'ISO di Proxmox VE con root su LVM. Su un sistema con BIOS legacy non fa nulla. Saltatelo se root è su ZFS: tali sistemi si avviano tramite proxmox-boot-tool e non sono interessati.

Verificare il risultato

Quando apt dist-upgrade termina senza errori, eseguite di nuovo lo strumento di verifica:

pve7to8 --full

Prima del riavvio, lo strumento può mostrare voci WARN sul kernel in esecuzione e su LXCFS che usa ancora la vecchia libreria FUSE. È normale: entrambe scompaiono dopo il riavvio con il nuovo kernel nel Passaggio 5. Non devono esserci voci FAIL.

Passaggio 5. Riavviare con il nuovo kernel

Riavviate il nodo. È obbligatorio anche se su Proxmox VE 7 usavate già il kernel opzionale 6.2:

reboot

Passaggio 6. Verificare il risultato

Svuotate la cache del browser oppure forzate il ricaricamento dell'interfaccia web con Ctrl+Shift+R (Cmd+Shift+R su macOS). Controllate la versione in Summary del nodo oppure con:

pveversion

Avviate le macchine virtuali e i container e verificate che funzionino. In un cluster, disattivate la modalità manutenzione sul nodo e proseguite con il nodo successivo, ripartendo dalla verifica dei requisiti.

Risoluzione dei problemi

L'aggiornamento vuole rimuovere proxmox-ve

Il messaggio W: (pve-apt-hook) You are attempting to remove the meta-package 'proxmox-ve'! significa che qualche repository è ancora configurato per Bullseye o non esiste per Bookworm. Controllate tutti i file in /etc/apt/sources.list.d/, correggete i repository ed eseguite di nuovo apt update. Non confermate la rimozione.

L'aggiornamento è stato interrotto

Se la connessione è caduta o l'aggiornamento si è fermato a metà, riconnettetevi alla sessione tmux oppure accedete di nuovo ed eseguite:

dpkg --configure -a
apt -f install
apt dist-upgrade

Errori di dipendenze per i pacchetti Ceph

Se apt dist-upgrade segnala dipendenze non soddisfatte per i pacchetti Ceph su un nodo senza Ceph, aggiungete il repository no-subscription di Ceph Quincy dal Passaggio 3 ed eseguite di nuovo apt update. Alcuni pacchetti di Proxmox VE possono richiederlo durante l'aggiornamento.

Il nodo non si avvia

Connettetevi tramite IP-KVM per vedere l'errore di avvio. Per i problemi con GRUB, consultate la pagina ufficiale Recover From Grub Failure.

Prossimi passi

Proxmox VE 8 non riceve più aggiornamenti. Pianificate l'aggiornamento a Proxmox VE 9 su Debian 13 Trixie, che segue la stessa procedura con lo strumento di verifica pve8to9.

Se preferite non eseguire in autonomia gli aggiornamenti di versione maggiore, gli specialisti di Amministrazione di sistema di INTROSERV possono pianificare ed eseguire l'aggiornamento per voi.