Solução da comunidade

SSD NVMe do Beelink ME Mini não aparece na interface do ZimaOS: diagnóstico

Beelink ME Mini users could read and write NVMe RAID pools while the ZimaOS dashboard misidentified drives or reported incorrect pool usage.

Em suma: se o RAID funcionar, mas o ZimaOS indicar que os discos NVMe estão em falta, suspeite primeiro do mapeamento das ranhuras, antes de suspeitar de uma falha do disco.

Em várias instalações do Beelink ME Mini, o armazenamento RAID 0/5 continuou legível e gravável através de SMB, enquanto o painel apresentava discos NVMe em falta ou informações incorretas sobre o espaço livre. Este padrão significa que o Linux e a camada RAID já conseguem detetar os dispositivos. A camada com problemas é o mapeamento/UI das ranhuras físicas do ZimaOS.

Armazenamento do ZimaOS a mostrar um conjunto RAID5 com discos NVMe indicados como em falta num Beelink ME Mini
O conjunto permaneceu acessível, mas o ZimaOS apresentou quatro ranhuras NVMe como em falta, apesar de o RAID subjacente estar a funcionar.
Armazenamento do ZimaOS a mostrar um conjunto RAID0 com membros NVMe em falta no mapa visual das ranhuras
Um segundo conjunto apresentou a mesma discrepância: armazenamento RAID utilizável por baixo da interface, mas apresentação incorreta dos discos físicos no painel.

Primeiro, confirme que o NVMe e o RAID estão saudáveis por baixo da interface

lsblk -o NAME,SIZE,FSTYPE,MOUNTPOINTS
lspci | grep -i "Non-Volatile"
cat /proc/mdstat
df -h

Se o RAID estiver montado, o SMB funcionar e os dispositivos NVMe esperados aparecerem em lspci/lsblk, não reconstrua a matriz apenas para corrigir o painel. Os ecrãs de armazenamento atuais do ZimaOS destinam-se a apresentar o estado dos discos, a capacidade e as informações de leitura/escrita assim que o mapeamento estiver correto.

O estado do armazenamento do ZimaOS apresenta o resultado esperado.

O mapeamento NVMe utiliza endereços PCI, não o HCTL do lsblk

Terminal do ZimaOS onde lsblk -o hctl devolve apenas o cabeçalho HCTL para dispositivos NVMe
Este diagnóstico falhado ilustra um erro comum: o HCTL é útil para dispositivos do tipo SCSI/SATA, enquanto o mapeamento NVMe requer endereços PCI.

A antiga correção para hardware não Zima utilizava lspci para NVMe. lsblk -o hctl é o ramo SATA/SCSI e pode não devolver nada útil para NVMe. Esta distinção resolveu a confusão no tópico.

A correção histórica do local-storage.conf

utilizado como solução alternativa da IceWhale para hardware não Zima /etc/casaos/local-storage.conf e atualizou o NVMe mapeamento para corresponder aos endereços PCI expostos por lspci, seguido de:

systemctl restart zimaos-local-storage

Mais tarde, os utilizadores descobriram que o comportamento real do analisador nas respetivas versões exigia endereços separados por espaços, em vez do exemplo separado por vírgulas publicado originalmente. Por se tratar de uma solução alternativa antiga e de baixo nível, faça uma cópia de segurança da configuração e dê prioridade ao comportamento atual do ZimaOS antes de a editar manualmente.

O mapeamento de discos não Zima preserva o procedimento histórico.

Como deve ser apresentada uma vista NVMe corrigida

Pool RAID5 do ZimaOS a apresentar três SSDs NVMe TEAMGROUP, com o estado, as temperaturas e zero por cento de utilização
Uma configuração posterior da Beelink apresentou o resultado pretendido: os modelos NVMe individuais, as capacidades e as temperaturas visíveis na interface de Armazenamento.
Pool RAID5 do ZimaOS a mostrar três SSDs NVMe Crucial de 2 TB com informações sobre o estado e a temperatura
Outra configuração corrigida apresentou os nomes dos modelos NVMe, a utilização e as temperaturas, em vez de cartões de discos em falta provisórios.
Ecrã de armazenamento RAID5 do ZimaOS a mostrar corretamente três SSDs NVMe Crucial de 4 TB detetados
Um mapa de ranhuras funcional com três unidades NVMe de 4 TB mostrou que o problema estava no mapeamento da interface, e não na funcionalidade RAID.
Armazenamento do ZimaOS a mostrar seis discos NVMe em falta no painel antes da correção do mapeamento PCI NVMe
As seis posições NVMe apareceram como em falta, embora o pool existisse, reforçando que a configuração das ranhuras visuais estava incorreta.
Pool RAID5 do ZimaOS a apresentar corretamente seis SSDs NVMe Crucial após a atualização do mapeamento dos endereços PCI
Depois de corrigir o mapeamento dos endereços PCI NVMe, os seis SSDs apareceram com os dados do modelo, da capacidade e da temperatura.

Quando o mapeamento estiver correto, o painel pode apresentar cada modelo de SSD, a capacidade, a temperatura e a utilização, em vez de cartões de discos em falta provisórios. A correção altera a forma como o ZimaOS associa os dispositivos PCI físicos às ranhuras visuais; não repara os dados do sistema de ficheiros.

Como verificar o estado do NVMe independentemente da interface

nvme list
nvme smart-log /dev/nvme0
smartctl -a /dev/nvme0

As verificações de estado do nvme-cli fornecem as ferramentas Linux padrão para NVMe. Utilize-as quando o painel for questionável, mas ainda precisar de provas sobre o estado da unidade.

Quando não deve editar o mapeamento das ranhuras

Se o dispositivo NVMe estiver ausente de lspci e lsblk, não tem um problema apenas da interface. Verifique primeiro a BIOS, o encaixe das unidades, o protocolo da ranhura, a alimentação e a compatibilidade do hardware. A edição do mapa de ranhuras não pode fazer aparecer uma unidade que não é detetada fisicamente.

O armazenamento do ZimaCube 2 e a recuperação de RAID fornecem arquiteturas de referência mais seguras.

Perguntas frequentes

Porque é que o meu RAID Beelink funciona quando o ZimaOS mostra discos em falta?

O Linux pode montar o RAID mesmo que o mapa visual de ranhuras do ZimaOS não corresponda à topologia PCI do Beelink.

Devo recriar o RAID para corrigir a ausência de placas NVMe?

Não. Se os dados estiverem legíveis e o conjunto estiver saudável, corrija ou comunique o problema de mapeamento da interface em vez de destruir um conjunto funcional.

Porque é que lsblk -o hctl não apresenta nada?

Os dispositivos NVMe são dispositivos PCIe e a solução antiga utilizava endereços lspci. O HCTL é mais relevante para o mapeamento de dispositivos do tipo SCSI/SATA.

Ainda posso utilizar o nvme-cli se a interface do ZimaOS estiver incorreta?

Sim, se o dispositivo estiver visível no Linux. O nvme smart-log pode fornecer informações sobre o estado, a temperatura e os contadores de erros independentemente do painel.

A edição de local-storage.conf continua a ser o primeiro passo recomendado?

Não. É uma solução histórica para hardware que não é Zima. Teste primeiro a versão atual e guarde uma cópia de segurança da configuração antes de fazer edições manuais.