El tutorial de la fuente de 2024 abordaba un problema de compatibilidad de visualización y mapeo en hardware que no era ZimaCube. Daba por hecho que las herramientas de Linux, como lsblk o lspci, ya podían detectar el dispositivo SATA o NVMe, pero la estantería de almacenamiento de ZimaOS no mapeaba correctamente la distribución del controlador de terceros.
Esta distinción es importante hoy porque el ZimaOS actual ha recibido varias correcciones para el almacenamiento de terceros. ZimaOS 1.4.4 solucionó explícitamente la ausencia en Almacenamiento de los discos NVMe de terceros, y la versión 1.6.1 optimizó la lógica de visualización de las estanterías de discos de equipos de terceros con muchos discos. Actualiza primero antes de editar el archivo de configuración histórico.
La solución histórica para SATA utilizaba SataStartNumber
La fuente oficial indicaba a los usuarios de SATA que inspeccionaran el direccionamiento del controlador con:
lsblk -o hctly luego editar /etc/casaos/local-storage.conf por lo que SataStartNumber coincidía con la numeración HCTL esperada por la máquina.
La solución histórica para NVMe utilizaba direcciones PCI
Para los dispositivos NVMe, la fuente utilizó lspci para identificar las direcciones PCI y las colocó en NVME campo del mismo archivo de configuración antes de reiniciar zimaos-local-storage.
El hilo contiene un desacuerdo real sobre el separador
El texto oficial de 2024 indica que varias direcciones NVMe deben separarse con comas. En octubre de 2025, un usuario de la comunidad informó que las comas no funcionaban en su sistema y que los espacios sí.
Esta contradicción debe permanecer visible. Es una prueba de que el formato del archivo manual o el comportamiento del analizador sintáctico cambió o difirió entre versiones; no es motivo para declarar que un separador es universalmente correcto para el ZimaOS actual.
ZimaOS 1.4.4 añadió una solución para discos NVMe de terceros a nivel de producto
Las notas de la versión 1.4.4 de IceWhale indican explícitamente que se solucionó la ausencia en Almacenamiento de los discos NVMe de dispositivos de terceros.
Consulta la solución oficial de visualización de discos NVMe de terceros.
ZimaOS 1.6.1 optimizó aún más las estanterías grandes de discos de terceros
Más adelante, IceWhale optimizó la lógica de visualización de las estanterías de discos cuando los dispositivos de terceros tienen demasiados discos. Esto se solapa directamente con el antiguo problema de mapeo de la interfaz y es otra razón por la que los usuarios actuales no deberían empezar editando una configuración de 2024.
Primero determina si Linux no detecta el disco o si solo falta en la interfaz de usuario
- Si
lspci/lsblkno puede ver el dispositivo, investiga el hardware, el modo del controlador, la alimentación, la conexión y la compatibilidad de los drivers. - Si Linux ve el dispositivo, pero Almacenamiento no, recopila la versión actual de ZimaOS y las evidencias de la interfaz y del servicio de almacenamiento.
Considera las ediciones de local-storage.conf como históricas o avanzadas
ZimaOS es ahora un sistema operativo de dispositivo mucho más inmutable que muchas distribuciones generales de Linux. Las ediciones manuales en /etc puede depender de la versión y ser reemplazado por actualizaciones posteriores. Conserva una copia del archivo original y consulta las indicaciones de soporte actuales si la interfaz moderna sigue identificando incorrectamente los discos.
Que falte una tarjeta de disco no equivale a que falte el disco
El tutorial original trataba principalmente sobre cómo se organizaban y exponían los discos de terceros en la interfaz de almacenamiento de ZimaOS. Si lsblk y los registros del kernel ven una unidad, pero la página de almacenamiento no la muestra correctamente, el problema es distinto del de un controlador o driver que no puede detectar el disco en absoluto.
Haz una copia de seguridad de local-storage.conf antes de editarlo
El método histórico modifica un archivo de configuración nativo de ZimaOS. Guarda primero el archivo original y registra la versión actual de ZimaOS para poder revertir el cambio si el estante de discos empeora después de modificarlo.
Como las versiones OTA han cambiado desde entonces la gestión de discos de terceros, un valor antiguo editado manualmente también puede quedar obsoleto después de una actualización.
Las direcciones PCI pueden cambiar cuando cambia la topología del hardware
Mover una tarjeta NVMe a otra ranura, cambiar una configuración de bifurcación PCIe o actualizar el firmware de la plataforma puede cambiar la forma en que se enumeran los dispositivos. Por lo tanto, una lista de direcciones codificada pertenece a esa topología de hardware, no al modelo de SSD en sí.
Conserva la discrepancia de separadores de la fuente
Las instrucciones oficiales de 2024 describen direcciones NVMe separadas por comas, mientras que posteriormente un usuario de la comunidad indicó que los espacios funcionaban en su sistema y las comas no. No hay suficiente evidencia de la fuente para reemplazar universalmente la sintaxis oficial por la variante de la comunidad.
En una versión actual, actualiza primero y utiliza el comportamiento exacto del analizador actual antes de editar el campo.
Los estantes de discos de terceros grandes recibieron posteriormente mejoras a nivel de producto
ZimaOS 1.6.1 mejoró específicamente el comportamiento de visualización de dispositivos de terceros con un mayor número de discos. Por lo tanto, los usuarios con tarjetas HBA, carcasas de varias bahías o más de seis unidades deberían reproducir el problema en la versión actual antes de cambiar la configuración heredada del número de estante.
Preguntas frecuentes sobre la visualización de discos de terceros
¿Que falte un disco en el estante de ZimaOS significa que Linux no puede verlo?
No. El tutorial original abordaba específicamente los casos en los que el hardware existía, pero la asignación de la interfaz de usuario era incorrecta.
¿ZimaOS añadió posteriormente soluciones oficiales?
Sí. La versión 1.4.4 solucionó la ausencia aparente de discos NVMe de terceros, y la 1.6.1 optimizó la visualización de estantes de discos de terceros.
¿Los usuarios actuales deberían editar a ciegas SataStartNumber o NVME?
No. Primero, actualiza y confirma la capa de fallo actual.
