Soluzione della community

L’aggiornamento di ZimaOS entra in modalità di emergenza: esegui prima il ripristino

A Proxmox ZimaOS system stopped booting after the 1.3.2 update, while the previous system slot still worked and later diagnostics implicated storage dependencies and custom mount state.

In sintesi: usa prima lo slot ZimaOS alternativo, poi individua la dipendenza esatta che causa la modalità di emergenza

ZimaOS 1.3.2 presentava un problema di compatibilità noto con alcune macchine di terze parti all'inizio del 2025. In questo caso Proxmox, lo slot A riusciva ancora ad avviare la versione precedente, mentre lo slot aggiornato entrava in modalità di emergenza. È proprio questo il tipo di problema da cui il design del sistema A/B è pensato per proteggere.

Schermata di avvio di ZimaOS che entra in modalità di emergenza dopo un aggiornamento e va in timeout su un dispositivo di archiviazione persistente
Il primo errore di avvio mostra ZimaOS che entra in modalità di emergenza dopo il timeout di un dispositivo di archiviazione, invece di raggiungere la dashboard.

Passaggio 1: avvia lo slot precedente da GRUB

Collegati alla console, visualizza GRUB usando i tasti freccia e scegli lo slot di sistema alternativo. Le versioni attuali di ZimaOS utilizzano ancora partizioni di sistema doppie per consentire un rapido rollback. La procedura di ripristino del sistema ZimaOS illustra il processo attuale.

Il modello degli slot di RAUC fornisce il concetto di base degli slot.

Passaggio 2: leggi il primo errore effettivo, non l'ultima riga della modalità di emergenza

Registro di avvio di ZimaOS con i dettagli dell'inizializzazione del kernel e della piattaforma durante l'indagine sul problema della versione 1.3.2
La seconda schermata diagnostica ha registrato i dettagli dell'inizializzazione del kernel mentre il guest Proxmox di terze parti non riusciva a completare il normale avvio.
Configurazione hardware della macchina virtuale Proxmox per il guest ZimaOS, inclusi dischi VirtIO SCSI e UEFI OVMF
La macchina virtuale utilizzava UEFI OVMF, rete VirtIO e più dischi SCSI, elementi importanti per confrontare l'errore con quello di altri hardware virtuali di terze parti.
Vista VNC di Proxmox che evidenzia un timeout per dev md zimaos prima che ZimaOS entri in modalità di emergenza
Una schermata successiva ha evidenziato il timeout esatto su /dev/md/zimaos, precedente agli errori delle dipendenze e alla modalità di emergenza.

La modalità di emergenza è la conseguenza. Cerca più in alto il primo dispositivo andato in timeout, il mount non riuscito o la dipendenza mancante. In questo caso, la schermata indicava un dispositivo di archiviazione prima che comparissero gli errori delle dipendenze successive.

journalctl -xb
systemctl --failed
lsblk -f
cat /etc/fstab

Passaggio 3: controlla le voci personalizzate di fstab prima di reinstallare

Terminale di ZimaOS che mostra voci personalizzate in /etc/fstab e il file fstab di overlay upper_etc durante la risoluzione dei problemi di avvio
L'ultimo indizio diagnostico era un percorso fstab modificato; IceWhale ha segnalato errori di avvio simili quando le voci di mount personalizzate entravano in conflitto con il processo di avvio dell'appliance.

Un'evoluzione successiva dello stesso caso ha rivelato una seconda causa importante: le modifiche manuali a /etc/fstab possono impedire l'avvio di ZimaOS quando manca un dispositivo indicato o l'ordine dei mount entra in conflitto con il processo di avvio dell'appliance. IceWhale ha segnalato un errore simile che coinvolgeva sia /etc/fstab sia la copia persistente dell'overlay.

Se hai aggiunto manualmente voci RAID o di mount, confrontale con la configurazione di archiviazione attuale e rimuovi solo quelle che comprendi. Per i normali mount di RAID e dischi, preferisci l'interfaccia Archiviazione di ZimaOS.

Perché il vecchio bug del driver della versione 1.3.2 non è un problema universale attuale

Il team di ingegneria ha riconosciuto problemi di compatibilità con hardware di terze parti in quella specifica versione. ZimaOS ha rilasciato molte versioni successive alla 1.3.2, quindi “la versione 1.3.2 ha bloccato la mia macchina virtuale Proxmox” deve essere considerato un dato storico, non una diagnosi per un sistema del 2026.

La procedura di ripristino dell'installazione di ZimaOS è il riferimento moderno per l'hardware x86 di terze parti.

Quando anche una nuova installazione entra in modalità di emergenza

È un forte indizio che il problema sia legato all'hardware virtuale, ai dischi dati collegati, allo stato dei mount persistenti o a una configurazione dell'host non supportata, e non soltanto alla vecchia partizione di sistema. Avvia il sistema con il minimo hardware virtuale necessario, poi aggiungi i dischi dati uno alla volta.

Proteggi i dati prima di modificare i metadati RAID o dei mount

Non azzerare le firme mdadm né ricreare gli array durante la risoluzione dei problemi di uno slot di avvio. Il ripristino RAID separa il ripristino dell'avvio da quello dell'array, mentre il backup di ZimaOS fornisce il livello di sicurezza.

Scopri cosa può e non può risolvere GRUB

GRUB può selezionare lo slot di sistema ZimaOS precedente, ma non ripara un mount dati danneggiato né una voce di filesystem non valida. I controlli di GNU GRUB illustrano il livello del bootloader. Se lo slot precedente si avvia, usa quell'ambiente funzionante per esaminare la configurazione di archiviazione ed eseguire il backup dei dati prima di modificare lo slot che presenta errori.

FAQ

Perché ZimaOS avvia il vecchio slot ma non quello nuovo?

Il vecchio slot contiene ancora la precedente immagine di sistema funzionante. Il nuovo slot potrebbe avere un problema di driver, mount o configurazione.

La modalità di emergenza significa che i miei dati sono persi?

No. Significa che le dipendenze del normale avvio non sono state soddisfatte. Controlla lo stato dell'archiviazione e dei mount prima di presumere una perdita del filesystem.

Una voce fstab errata può impedire l'avvio di ZimaOS?

Sì. Un mount che non può essere soddisfatto può bloccare l'avvio o portare il sistema in modalità di emergenza.

Devo reinstallare immediatamente?

No. Prova prima lo slot A/B alternativo e individua la prima dipendenza che ha avuto esito negativo. Reinstalla solo quando il ripristino non è praticabile.

ZimaOS è supportato in Proxmox?

Le installazioni virtualizzate possono funzionare, ma l'hardware virtuale di terze parti può evidenziare differenze di compatibilità. Esegui i test sulla versione attuale e mantieni una possibilità di rollback.