Communityoplossing

Beelink ME Mini NVMe ontbreekt in de ZimaOS-gebruikersinterface: diagnose stellen

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

Kort gezegd: als de RAID werkt maar ZimaOS meldt dat de NVMe-schijven ontbreken, controleer dan eerst de sleufmapping voordat je uitgaat van een schijfstoring

Op verschillende Beelink ME Mini-installaties bleef RAID 0/5-opslag leesbaar en beschrijfbaar via SMB, terwijl het dashboard ontbrekende NVMe-schijven of onjuiste informatie over de vrije ruimte toonde. Dat patroon betekent dat Linux en de RAID-laag de apparaten al kunnen zien. De defecte laag is de fysieke-sleufmapping/-UI van ZimaOS.

ZimaOS-opslag met een RAID5-pool waarvan NVMe-schijven als ontbrekend worden gemeld op een Beelink ME Mini
De pool bleef toegankelijk, maar ZimaOS gaf vier NVMe-sleuven weer als ontbrekend, hoewel de onderliggende RAID correct werkte.
ZimaOS-opslag met een RAID0-pool waarvan NVMe-schijven ontbreken in de visuele sleufindeling
Een tweede pool vertoonde dezelfde afwijking: bruikbare RAID-opslag onderliggend, maar onjuiste weergave van fysieke schijven in het dashboard.

Controleer eerst of de NVMe en RAID onder de gebruikersinterface gezond zijn

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

Als de RAID is aangekoppeld, SMB werkt en de verwachte NVMe-apparaten verschijnen in lspci/lsblk, bouw de array niet opnieuw op alleen om het dashboard te herstellen. De huidige opslagschermen van ZimaOS zijn bedoeld om de schijfstatus, capaciteit en lees-/schrijfinformatie weer te geven zodra de mapping correct is.

De opslagstatus van ZimaOS toont de verwachte eindstatus.

NVMe-mapping gebruikt PCI-adressen, niet lsblk HCTL

ZimaOS-terminal waarin lsblk -o hctl voor NVMe-apparaten alleen de HCTL-koptekst retourneert
Deze mislukte diagnose illustreert een veelgemaakte fout: HCTL is nuttig voor SCSI/SATA-achtige apparaten, terwijl voor NVMe-mapping PCI-adressen nodig zijn.

De oude oplossing voor niet-Zima-hardware gebruikte lspci voor NVMe. lsblk -o hctl is de SATA/SCSI-tak en kan niets bruikbaars opleveren voor NVMe. Dit onderscheid nam de verwarring in de discussie weg.

De historische oplossing voor local-storage.conf

IceWhale’s tijdelijke oplossing voor niet-Zima-hardware /etc/casaos/local-storage.conf en bijgewerkt NVME een toewijzing die overeenkomt met de PCI-adressen die worden weergegeven door lspci, gevolgd door:

systemctl restart zimaos-local-storage

Latere gebruikers ontdekten dat de parser in hun builds spaties tussen adressen vereiste in plaats van komma's, zoals in het oorspronkelijk gepubliceerde voorbeeld. Maak vanwege deze oude workaround op laag niveau eerst een back-up van de configuratie en geef de huidige werking van ZimaOS de voorkeur voordat je handmatig wijzigingen aanbrengt.

De schijftoewijzing voor niet-Zima-apparaten bewaart de historische procedure.

Zo ziet een gecorrigeerde NVMe-weergave eruit

ZimaOS RAID5-pool met drie TEAMGROUP NVMe-SSD's, met gezondheidsinformatie, temperaturen en nul procent gebruik
Een latere Beelink-configuratie liet het beoogde resultaat zien: afzonderlijke NVMe-modellen, capaciteiten en temperaturen waren zichtbaar in de opslaginterface.
ZimaOS RAID5-pool met drie Crucial NVMe-SSD's van 2 TB, inclusief gezondheids- en temperatuurinformatie
Een andere gecorrigeerde configuratie toonde NVMe-modelnamen, gebruik en temperaturen in plaats van tijdelijke kaarten voor ontbrekende schijven.
ZimaOS RAID5-opslagscherm waarop drie Crucial NVMe-SSD's van 4 TB correct worden gedetecteerd
Een werkende slotindeling met drie NVMe-schijven van 4 TB liet zien dat het probleem in de UI-toewijzing zat en niet in de RAID-functionaliteit.
ZimaOS-opslag met zes ontbrekende NVMe-schijven in het dashboard vóór het corrigeren van de NVMe-PCI-toewijzing
Alle zes NVMe-posities werden als ontbrekend weergegeven, hoewel de pool bestond. Dit bevestigde dat de visuele slotconfiguratie onjuist was.
ZimaOS RAID5-pool met zes Crucial NVMe-SSD's, correct weergegeven nadat de PCI-adrestoewijzing was bijgewerkt
Nadat de NVMe-PCI-adrestoewijzing was gecorrigeerd, verschenen alle zes SSD's met model-, capaciteits- en temperatuurgegevens.

Zodra de toewijzing klopt, kan het dashboard elk SSD-model, de capaciteit, temperatuur en het gebruik tonen in plaats van tijdelijke kaarten voor ontbrekende schijven. De oplossing wijzigt de manier waarop ZimaOS fysieke PCI-apparaten aan visuele slots koppelt; de gegevens op het bestandssysteem worden er niet door hersteld.

NVMe-gezondheid onafhankelijk van de UI controleren

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

De nvme-cli-gezondheidscontroles bieden de standaard Linux-tools voor NVMe. Gebruik deze wanneer het dashboard twijfelachtig is, maar je nog steeds bewijs van de schijfgezondheid nodig hebt.

Wanneer je de slotindeling niet moet bewerken

Als het NVMe-apparaat ontbreekt in lspci en lsblk, dan heb je niet alleen een UI-probleem. Controleer eerst het BIOS, de plaatsing van de schijven, het slotprotocol, de voeding en de hardwarecompatibiliteit. Een wijziging van de slotindeling kan een fysiek niet-gedetecteerde schijf niet zichtbaar maken.

De ZimaCube 2-opslag en RAID-herstel bieden veiligere referentiearchitecturen.

Veelgestelde vragen

Waarom werkt mijn Beelink-RAID als ZimaOS ontbrekende schijven toont?

Linux kan de RAID samenstellen en koppelen, zelfs als de visuele slotindeling van ZimaOS niet overeenkomt met de PCI-topologie van de Beelink.

Moet ik de RAID opnieuw aanmaken om ontbrekende NVMe-kaarten te herstellen?

Nee. Als de gegevens leesbaar zijn en de array gezond is, herstel of meld dan de UI-koppeling in plaats van een werkende array te vernietigen.

Waarom toont lsblk -o hctl niets?

NVMe-apparaten zijn PCIe-apparaten en de oude workaround gebruikte lspci-adressen. HCTL is relevanter voor SCSI-/SATA-achtige apparaatkoppelingen.

Kan ik nvme-cli nog steeds gebruiken als de ZimaOS-interface onjuist is?

Ja, als het apparaat zichtbaar is voor Linux. nvme smart-log kan onafhankelijk van het dashboard informatie geven over de gezondheid, temperatuur en fouttellers.

Is het bewerken van local-storage.conf nog steeds de aanbevolen eerste stap?

Nee. Het is een historische workaround voor hardware die niet van Zima is. Test eerst de huidige release en bewaar een back-up van de configuratie voordat je handmatige wijzigingen aanbrengt.