Il tutorial del 2024 affrontava un problema di compatibilità di visualizzazione/mappatura sull'hardware non ZimaCube. Presupponeva che il dispositivo SATA o NVMe fosse già visibile agli strumenti Linux come lsblk o lspci, ma lo scaffale di archiviazione di ZimaOS non mappava correttamente la configurazione del controller di terze parti.
Questa distinzione è importante oggi perché da allora ZimaOS ha ricevuto diverse correzioni per lo storage di terze parti. ZimaOS 1.4.4 ha corretto esplicitamente il problema dei dischi NVMe di terze parti che risultavano mancanti nella sezione Archiviazione, mentre la versione 1.6.1 ha ottimizzato la logica di visualizzazione degli scaffali di dischi per i dispositivi di terze parti con molti dischi. Aggiorna prima il sistema, quindi modifica il file di configurazione storico.
La correzione storica per i SATA utilizzava SataStartNumber
La fonte ufficiale indicava agli utenti SATA di esaminare l'indirizzamento del controller con:
lsblk -o hctle poi modifica /etc/casaos/local-storage.conf quindi SataStartNumber corrispondeva alla numerazione HCTL prevista dalla macchina.
La correzione storica per gli NVMe utilizzava gli indirizzi PCI
Per i dispositivi NVMe, la fonte utilizzava lspci per identificare gli indirizzi PCI e li inseriva nel NVME campo dello stesso file di configurazione prima del riavvio zimaos-local-storage.
La discussione contiene un reale disaccordo sul separatore
Il testo ufficiale del 2024 afferma che gli indirizzi NVMe multipli devono essere separati da virgole. Nell'ottobre 2025, un utente della community ha riferito che sul proprio sistema le virgole non funzionavano, mentre gli spazi sì.
Questa contraddizione dovrebbe rimanere visibile. È una prova del fatto che il formato del file manuale o il comportamento del parser siano cambiati o differiscano tra le versioni; non è un motivo per dichiarare universalmente corretto un separatore per le versioni attuali di ZimaOS.
ZimaOS 1.4.4 ha aggiunto una correzione a livello di prodotto per gli NVMe di terze parti
Le note di rilascio di IceWhale 1.4.4 dichiarano esplicitamente che è stato risolto il problema dei dischi NVMe provenienti da dispositivi di terze parti che risultavano mancanti nella sezione Archiviazione.
Consulta la correzione ufficiale per la visualizzazione degli NVMe di terze parti.
ZimaOS 1.6.1 ha ottimizzato ulteriormente gli scaffali di dischi di grandi dimensioni di terze parti
In seguito IceWhale ha ottimizzato la logica di visualizzazione degli scaffali di dischi quando i dispositivi di terze parti contengono troppi dischi. Questo si sovrappone direttamente al vecchio problema di mappatura dell'interfaccia ed è un ulteriore motivo per cui gli utenti attuali non dovrebbero iniziare modificando una configurazione del 2024.
Determina innanzitutto se il disco è assente da Linux o solo dall'interfaccia utente
- Se
lspci/lsblknon riesce a vedere il dispositivo, verifica l'hardware, la modalità del controller, l'alimentazione, il corretto inserimento e il supporto dei driver. - Se Linux vede il dispositivo, ma Archiviazione no, raccogli la versione attuale di ZimaOS e le informazioni sull'interfaccia e sul servizio di archiviazione.
Considera le modifiche a local-storage.conf come storiche/avanzate
ZimaOS è ora un sistema operativo appliance più immutabile rispetto a molte distribuzioni Linux generiche. Le modifiche manuali in /etc può dipendere dalla versione e potrebbe essere sostituito da aggiornamenti successivi. Conserva una copia del file originale e segui le indicazioni dell'assistenza attuali se l'interfaccia moderna identifica ancora erroneamente i dischi.
Un riquadro del disco mancante non equivale a un disco mancante
Il tutorial originale riguardava principalmente il modo in cui i dischi di terze parti venivano disposti e resi disponibili nell'interfaccia Archiviazione di ZimaOS. Se lsblk e i log del kernel vedono un'unità, ma la pagina Archiviazione non la visualizza correttamente, il problema è diverso da quello di un controller o driver che non riesce a rilevare affatto il disco.
Esegui il backup di local-storage.conf prima di modificarlo
Il metodo storico modifica un file di configurazione nativo di ZimaOS. Salva prima il file originale e annota la versione attuale di ZimaOS, così potrai ripristinarlo se dopo la modifica lo scaffale dei dischi peggiora.
Poiché gli aggiornamenti OTA hanno modificato nel frattempo la gestione dei dischi di terze parti, anche un vecchio valore modificato manualmente potrebbe diventare obsoleto dopo un aggiornamento.
Gli indirizzi PCI possono cambiare quando cambia la topologia hardware
Spostare una scheda NVMe in un altro slot, modificare un'impostazione di biforcazione PCIe o aggiornare il firmware della piattaforma può cambiare il modo in cui i dispositivi vengono enumerati. Un elenco di indirizzi codificato manualmente è quindi legato a quella topologia hardware, non al modello dell'SSD.
Mantieni la discrepanza sui separatori presente nella fonte
Le istruzioni ufficiali del 2024 descrivono indirizzi NVMe separati da virgole, mentre in seguito un utente della community ha affermato che sul suo sistema gli spazi funzionavano e le virgole no. Non ci sono prove sufficienti per sostituire universalmente la sintassi ufficiale con la variante della community.
Nella versione attuale, aggiorna prima il sistema e usa il comportamento esatto del parser corrente prima di modificare il campo.
Gli scaffali di dischi di terze parti di grandi dimensioni hanno ricevuto in seguito miglioramenti a livello di prodotto
ZimaOS 1.6.1 ha migliorato specificamente il comportamento di visualizzazione dei dispositivi di terze parti con un numero elevato di dischi. Gli utenti con schede HBA, enclosure multi-bay o più di sei unità dovrebbero quindi riprodurre il problema nella versione attuale prima di modificare le impostazioni legacy relative alla numerazione dello scaffale.
FAQ sulla visualizzazione dei dischi di terze parti
Se un disco manca nello scaffale di ZimaOS, significa che Linux non riesce a vederlo?
No. Il tutorial originale riguardava specificamente i casi in cui l'hardware era presente, ma la mappatura nell'interfaccia utente era errata.
ZimaOS ha aggiunto in seguito correzioni ufficiali?
Sì. La versione 1.4.4 ha risolto il problema dei dischi NVMe di terze parti visualizzati come mancanti, mentre la versione 1.6.1 ha ottimizzato la visualizzazione degli scaffali di dischi di terze parti.
Gli utenti attuali dovrebbero modificare alla cieca SataStartNumber o NVME?
No. Prima aggiorna e conferma il livello attuale del guasto.
