Solution communautaire

SSD NVMe du Beelink ME Mini absent dans l’interface de ZimaOS : diagnostic

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

En résumé : si le RAID fonctionne mais que ZimaOS indique que les disques NVMe sont manquants, suspectez d’abord la correspondance des emplacements plutôt qu’une défaillance des disques.

Sur plusieurs installations de Beelink ME Mini, le stockage RAID 0/5 restait lisible et inscriptible via SMB, tandis que le tableau de bord affichait des disques NVMe manquants ou des informations incorrectes sur l’espace libre. Ce schéma signifie que Linux et la couche RAID voient déjà les périphériques. La couche défaillante est la correspondance des emplacements physiques et l’interface de ZimaOS.

Stockage ZimaOS affichant un pool RAID5 dont les disques NVMe étaient signalés comme manquants sur un Beelink ME Mini
Le pool restait accessible, mais ZimaOS affichait quatre emplacements NVMe comme manquants, alors que le RAID sous-jacent fonctionnait.
Stockage ZimaOS affichant un pool RAID0 dont les membres NVMe sont absents de la carte visuelle des emplacements
Un deuxième pool présentait le même décalage : le stockage RAID était utilisable sous-jacent, mais la présentation des disques physiques dans le tableau de bord était incorrecte.

Prouvez d’abord que le NVMe et le RAID fonctionnent correctement sous l’interface

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

Si le RAID est monté, que SMB fonctionne et que les périphériques NVMe attendus apparaissent dans lspci/lsblk, ne reconstruisez pas la grappe uniquement pour corriger le tableau de bord. Les écrans de stockage actuels de ZimaOS sont conçus pour afficher l’état des disques, la capacité et les informations de lecture/écriture une fois la correspondance correcte.

Le statut du stockage de ZimaOS fournit l’état final attendu.

La correspondance NVMe utilise les adresses PCI, et non lsblk HCTL

Terminal de ZimaOS où lsblk -o hctl ne renvoie que l’en-tête HCTL pour les périphériques NVMe
Ce diagnostic infructueux illustre une erreur courante : HCTL est utile pour les périphériques de type SCSI/SATA, tandis que la correspondance NVMe nécessite plutôt des adresses PCI.

L’ancien correctif pour le matériel non-Zima utilisait lspci pour le NVMe. lsblk -o hctl correspond à la branche SATA/SCSI et peut ne rien renvoyer d’utile pour le NVMe. Cette distinction a dissipé la confusion dans le fil de discussion.

Le correctif historique de local-storage.conf

solution de contournement d’IceWhale pour le matériel non-Zima utilisée /etc/casaos/local-storage.conf et mis à jour le NVME un mappage correspondant aux adresses PCI exposées par lspci, suivi de :

systemctl restart zimaos-local-storage

Des utilisateurs ultérieurs ont constaté que le comportement réel de l’analyseur dans leurs versions nécessitait des adresses séparées par des espaces plutôt que l’exemple séparé par des virgules publié à l’origine. Comme il s’agit d’une ancienne solution de contournement bas niveau, sauvegardez la configuration et privilégiez d’abord le comportement actuel de ZimaOS avant de la modifier manuellement.

Le mappage des disques non-Zima préserve la procédure historique.

À quoi ressemble une vue NVMe corrigée

Pool RAID5 de ZimaOS affichant trois SSD NVMe TEAMGROUP avec leur état, leur température et une utilisation de zéro pour cent
Une configuration Beelink ultérieure a montré le résultat attendu : les modèles, capacités et températures individuels des disques NVMe étaient visibles dans l’interface de stockage.
Pool RAID5 de ZimaOS affichant trois SSD NVMe Crucial de 2 To avec leurs informations d’état et de température
Une autre configuration corrigée affichait les noms des modèles NVMe, l’utilisation et les températures au lieu de cartes indiquant des disques manquants fictifs.
Écran de stockage RAID5 de ZimaOS affichant correctement trois SSD NVMe Crucial de 4 To détectés
Une configuration fonctionnelle des emplacements avec trois disques NVMe de 4 To a montré que le problème concernait le mappage de l’interface, et non le fonctionnement du RAID.
Stockage ZimaOS affichant six disques NVMe manquants dans le tableau de bord avant la correction du mappage PCI NVMe
Les six emplacements NVMe apparaissaient comme manquants alors que le pool existait, ce qui confirmait que la configuration des emplacements visuels était incorrecte.
Pool RAID5 de ZimaOS affichant correctement six SSD NVMe Crucial après la mise à jour du mappage des adresses PCI
Après avoir corrigé le mappage des adresses PCI NVMe, les six SSD sont apparus avec leurs informations de modèle, de capacité et de température.

Une fois le mappage correct, le tableau de bord peut afficher le modèle, la capacité, la température et l’utilisation de chaque SSD au lieu de cartes indiquant des disques manquants fictifs. La correction modifie la manière dont ZimaOS associe les périphériques PCI physiques aux emplacements visuels ; elle ne répare pas les données du système de fichiers.

Comment vérifier l’état de santé d’un NVMe indépendamment de l’interface

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

Les vérifications d’état de nvme-cli fournissent les outils NVMe Linux standard. Utilisez-les lorsque le tableau de bord est douteux, mais que vous avez tout de même besoin d’éléments sur l’état de santé du disque.

Quand ne pas modifier la correspondance des emplacements

Si l’appareil NVMe est absent de lspci et lsblk, vous n’avez pas un simple problème d’interface. Vérifiez d’abord le BIOS, l’insertion des disques, le protocole des emplacements, l’alimentation et la compatibilité matérielle. Une modification de la correspondance des emplacements ne peut pas faire apparaître un disque physiquement non détecté.

Le stockage du ZimaCube 2 et la récupération RAID fournissent des architectures de référence plus sûres.

FAQ

Pourquoi mon RAID Beelink fonctionne-t-il alors que ZimaOS affiche des disques manquants ?

Linux peut assembler et monter le RAID même si la correspondance visuelle des emplacements de ZimaOS ne correspond pas à la topologie PCIe du Beelink.

Dois-je recréer le RAID pour corriger l’absence des cartes NVMe ?

Non. Si les données sont lisibles et que la matrice est saine, corrigez la correspondance dans l’interface ou signalez le problème au lieu de détruire une matrice fonctionnelle.

Pourquoi lsblk -o hctl n’affiche-t-il rien ?

Les appareils NVMe sont des appareils PCIe, et l’ancien contournement utilisait les adresses lspci. HCTL est plus pertinent pour la correspondance des appareils de type SCSI/SATA.

Puis-je toujours utiliser nvme-cli si l’interface de ZimaOS est incorrecte ?

Oui, si l’appareil est visible par Linux. nvme smart-log peut fournir indépendamment du tableau de bord l’état de santé, la température et les compteurs d’erreurs.

La modification de local-storage.conf est-elle toujours l’étape initiale recommandée ?

Non. Il s’agit d’un contournement historique pour le matériel non-Zima. Testez d’abord la version actuelle et conservez une sauvegarde de la configuration avant toute modification manuelle.