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.

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

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.
