Soluzione della community

SSD NVMe ZimaOS non visibile nell’interfaccia web: controlla la mappatura degli alloggiamenti

A ZimaCube NVMe was detected by PCIe but mapped incorrectly in the UI; IceWhale's local-storage.conf reset fixed the original ZimaCube case.

Se un SSD NVMe viene rilevato da Linux ma visualizzato nel vano ZimaCube sbagliato o non mostrato correttamente nell'interfaccia dello spazio di archiviazione, il problema potrebbe riguardare i metadati della mappatura dei vani di ZimaOS anziché l'SSD stesso. Controlla prima il rilevamento PCIe, quindi usa il ripristino di local-storage.conf solo sull'hardware per il quale IceWhale ha documentato o consigliato questa soluzione.

La discussione originale presenta un'importante distinzione tra modelli: l'eliminazione della NVME=... la riga e riavviando zimaos-local-storage.service ha corretto il caso originale di ZimaCube, ma in seguito IceWhale ha affermato che il metodo si applicava a ZimaCube e non funzionava allo stesso modo su un Intel NUC generico.

Vista dello spazio di archiviazione di ZimaOS che mostra l'illustrazione del vano NVMe con lo stato dell'SSD errato o mancante
L'SSD era presente nel sistema, ma l'interfaccia dei vani di ZimaOS mostrava lo slot NVMe in modo errato. Fonte: forum della community IceWhale.

Passaggio 1: verifica che l'NVMe esista a livello PCIe

Esegui:

lspci | grep -i -E 'non-volatile|nvme'
lsblk -o NAME,SIZE,MODEL,SERIAL

Se l'SSD non compare in nessuna delle due viste hardware, il problema non riguarda semplicemente l'illustrazione dei vani di ZimaOS.

La guida alla risoluzione dei problemi di rilevamento dello spazio di archiviazione è utile quando l'NVMe manca a livello hardware, anziché essere semplicemente rappresentato in modo errato nell'interfaccia web.

Passaggio 2: controlla la mappatura dei vani di ZimaCube

Sul modello ZimaCube interessato, IceWhale ha richiesto:

sudo -i
cat /etc/casaos/local-storage.conf

La configurazione conteneva un NVME=... mappatura che non corrispondeva più alla posizione dell'SSD.

Passaggio 3: usa il ripristino solo sul modello previsto

IceWhale ha indicato all'utente di ZimaCube di rimuovere la NVME=... la riga, quindi esegui:

systemctl restart zimaos-local-storage.service

L'utente originale ha confermato che questa procedura ha corretto l'interfaccia utente.

Perché spostare l'SSD può ricreare il problema

In seguito, un utente ha spostato l'SSD da un vano a un altro e la mappatura errata è ricomparsa. È comprensibile se la mappa dei vani memorizzata nella cache o personalizzata non corrisponde più al nuovo slot fisico.

Non applicarlo indiscriminatamente all'hardware generico

Output del terminale con lspci e la configurazione dello spazio di archiviazione locale di CasaOS con la mappatura degli slot NVMe
Un test successivo su un dispositivo diverso da ZimaCube ha mostrato perché la soluzione alternativa local-storage.conf era specifica del modello. Fonte: forum della community IceWhale.

Un utente con un Intel NUC ha provato la stessa modifica e la riga NVMe è ricomparsa senza correggere l'interfaccia utente. IceWhale ha specificato esplicitamente che il metodo si applicava a ZimaCube e che il comportamento più ampio dei vani personalizzati per altre unità era ancora in fase di sviluppo.

Controlla prima l'interfaccia utente dello spazio di archiviazione attuale

L'attuale guida alla configurazione dello spazio di archiviazione di ZimaOS documenta il rilevamento attuale dei dischi e la configurazione dello spazio di archiviazione. Se l'SSD è visibile come normale spazio di archiviazione ma l'illustrazione dell'alloggiamento è errata, consideralo un problema di presentazione o mappatura.

Usa con attenzione i privilegi di root

La discussione originale chiariva inoltre che la modifica di /etc/casaos/local-storage.conf richiede privilegi di root. Non forzare la scrittura del file da una sessione utente normale.

Distingui il rilevamento fisico dalla presentazione degli alloggiamenti

La pagina Archiviazione di ZimaCube cerca di associare i controller NVMe rilevati alle etichette degli alloggiamenti fisici. Questo livello aggiuntivo di presentazione spiega perché un disco può essere perfettamente visibile a Linux, ma comparire sotto la lettera sbagliata o con un'icona dell'alloggiamento anomala.

Prima di modificare la configurazione, annota il modello dell'SSD, l'indirizzo PCI e lo slot fisico. In questo modo avrai una mappa prima/dopo e ridurrai il rischio di “correggere” il dispositivo sbagliato.

Esegui il backup di local-storage.conf prima di modificarlo

Se il supporto IceWhale ti indica di modificare il file, creane prima una copia:

sudo -i
cp /etc/casaos/local-storage.conf /etc/casaos/local-storage.conf.bak

Quindi apporta solo la modifica richiesta. Evita di riscrivere impostazioni di archiviazione non correlate, perché il file contiene più della mappatura NVMe.

Riavvia prima il servizio di archiviazione, non l'intero server

La soluzione verificata per ZimaCube riavviava zimaos-local-storage.service dopo aver eliminato la mappatura obsoleta. Si tratta di un test più circoscritto rispetto al riavvio dell'intero NAS e facilita la verifica che il servizio di archiviazione locale abbia ricostruito correttamente la mappa degli alloggiamenti.

Se la mappatura continua a ricomparire

Quando la stessa mappatura obsoleta ricompare dopo ogni riavvio, smetti di modificare ripetutamente il file. Acquisisci la configurazione generata, lspci, lsblk, lo slot fisico e la versione attuale di ZimaOS per l'assistenza. Una rigenerazione persistente indica che un altro componente sta scrivendo la mappatura.

La {ilink("https://shop.zimaspace.com/pages/zimaos-installation-troubleshooting-guide","guida alla risoluzione dei problemi di archiviazione","Raccogli informazioni sul rilevamento hardware e sui metadati dell'archiviazione prima di apportare ripetute modifiche a livello di sistema")} offre un approccio più sicuro per l'escalation.

Domande frequenti

Eliminare la riga NVME cancella l'SSD?

La soluzione alternativa della fonte modificava la configurazione della mappatura degli alloggiamenti, non il contenuto del disco. Tuttavia, esegui un backup dei dati importanti prima di apportare modifiche all'archiviazione a livello di sistema.

Perché l'SSD è visibile in lspci ma non viene visualizzato correttamente nell'interfaccia?

Questo indica un problema nei metadati dello spazio di archiviazione di ZimaOS o nella mappatura degli alloggiamenti, piuttosto che nel rilevamento PCIe di base.

Posso usare questa soluzione su un Intel NUC?

Non come regola generale. IceWhale ha specificato che la soluzione alternativa si applicava a ZimaCube.

E se l'SSD non compare in lspci?

Quindi controlla innanzitutto lo slot hardware, l'SSD, le impostazioni BIOS/PCIe e il collegamento fisico.