Community-Lösung

Beelink ME Mini NVMe wird in der ZimaOS-Benutzeroberfläche nicht angezeigt: Fehlerdiagnose

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

Kurz gesagt: Wenn das RAID funktioniert, ZimaOS aber meldet, dass die NVMe-Datenträger fehlen, sollten Sie zunächst die Steckplatzzuordnung und nicht einen Datenträgerausfall vermuten.

Bei mehreren Beelink-ME-Mini-Installationen blieb RAID-0/5-Speicher über SMB les- und beschreibbar, während das Dashboard fehlende NVMe-Datenträger oder falsche Angaben zum freien Speicherplatz anzeigte. Dieses Muster bedeutet, dass Linux und die RAID-Schicht die Geräte bereits erkennen können. Die fehlerhafte Schicht ist die Zuordnung der physischen Steckplätze beziehungsweise die Benutzeroberfläche von ZimaOS.

ZimaOS-Speicher zeigt einen RAID5-Pool mit auf einem Beelink ME Mini als fehlend gemeldeten NVMe-Datenträgern
Der Pool blieb zugänglich, aber ZimaOS zeigte vier NVMe-Steckplätze als fehlend an, obwohl das zugrunde liegende RAID funktionierte.
ZimaOS-Speicher zeigt einen RAID0-Pool mit fehlenden NVMe-Mitgliedern in der visuellen Steckplatzübersicht
Ein zweiter Pool zeigte dieselbe Abweichung: Darunter war der RAID-Speicher nutzbar, doch im Dashboard wurden die physischen Datenträger falsch dargestellt.

Zuerst nachweisen, dass NVMe und RAID unterhalb der Benutzeroberfläche ordnungsgemäß funktionieren

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

Wenn das RAID eingebunden ist, SMB funktioniert und die erwarteten NVMe-Geräte in lspci/lsblk; bauen Sie das Array nicht nur neu auf, um das Dashboard zu reparieren. Die aktuellen ZimaOS-Speicheransichten sollen den Zustand der Datenträger, die Kapazität sowie Lese-/Schreibinformationen anzeigen, sobald die Zuordnung korrekt ist.

Der ZimaOS-Speicherstatus zeigt den erwarteten Endzustand.

Die NVMe-Zuordnung verwendet PCI-Adressen, nicht lsblk HCTL

ZimaOS-Terminal, in dem lsblk -o hctl für NVMe-Geräte nur die HCTL-Kopfzeile zurückgibt
Diese fehlgeschlagene Diagnose veranschaulicht einen häufigen Fehler: HCTL ist für Geräte im SCSI-/SATA-Stil nützlich, während die NVMe-Zuordnung stattdessen PCI-Adressen benötigt.

Die alte Korrektur für Hardware, die nicht von Zima stammt, verwendete lspci für NVMe. lsblk -o hctl ist der SATA/SCSI-Zweig und kann für NVMe keine nützlichen Ergebnisse liefern. Diese Unterscheidung klärte die Verwirrung im Thread.

Die historische Korrektur für local-storage.conf

Die von IceWhale verwendete Umgehungslösung für Hardware, die nicht von Zima stammt, /etc/casaos/local-storage.conf und die aktualisierte NVMe Zuordnung entsprechend den von lspci, gefolgt von:

systemctl restart zimaos-local-storage

Spätere Benutzer stellten fest, dass das tatsächliche Parserverhalten in ihren Builds durch Leerzeichen getrennte Adressen statt des ursprünglich veröffentlichten, durch Kommas getrennten Beispiels erforderte. Da es sich um einen alten Low-Level-Workaround handelt, sollten Sie die Konfiguration sichern und vor einer manuellen Bearbeitung zunächst das aktuelle Verhalten von ZimaOS bevorzugen.

Die Zuordnung nicht von Zima stammender Laufwerke bewahrt das historische Verfahren.

So sieht eine korrigierte NVMe-Ansicht aus

ZimaOS-RAID5-Pool mit drei TEAMGROUP-NVMe-SSDs, einschließlich Zustandstemperaturen und null Prozent Auslastung
Eine spätere Beelink-Konfiguration zeigte das gewünschte Ergebnis: einzelne NVMe-Modelle, Kapazitäten und Temperaturen waren in der Speicheroberfläche sichtbar.
ZimaOS-RAID5-Pool mit drei Crucial-2-TB-NVMe-SSDs sowie Informationen zu Zustand und Temperatur
Eine weitere korrigierte Konfiguration zeigte NVMe-Modellnamen, Auslastung und Temperaturen statt Platzhalterkarten für fehlende Laufwerke.
ZimaOS-RAID5-Speicheransicht mit drei korrekt erkannten Crucial-4-TB-NVMe-SSDs
Eine funktionierende Steckplatzzuordnung mit drei 4-TB-NVMe-Laufwerken zeigte, dass es sich um ein Problem der UI-Zuordnung und nicht der RAID-Funktionalität handelte.
ZimaOS-Speicheransicht mit sechs fehlenden NVMe-Laufwerken im Dashboard vor der Korrektur der NVMe-PCI-Zuordnung
Alle sechs NVMe-Positionen wurden als fehlend angezeigt, obwohl der Pool vorhanden war. Dies bestätigte, dass die Konfiguration der visuellen Steckplätze falsch war.
ZimaOS-RAID5-Pool mit sechs Crucial-NVMe-SSDs nach der Aktualisierung der PCI-Adresszuordnung korrekt angezeigt
Nach der Korrektur der NVMe-PCI-Adresszuordnung wurden alle sechs SSDs mit Modell-, Kapazitäts- und Temperaturdaten angezeigt.

Sobald die Zuordnung korrekt ist, kann das Dashboard für jedes SSD-Modell Größe, Temperatur und Auslastung anzeigen, statt Platzhalterkarten für fehlende Laufwerke. Die Korrektur ändert, wie ZimaOS physische PCI-Geräte visuellen Steckplätzen zuordnet; sie repariert keine Dateisystemdaten.

So prüfen Sie den NVMe-Zustand unabhängig von der Benutzeroberfläche

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

Die nvme-cli-Gesundheitsprüfungen stellen die standardmäßigen Linux-Werkzeuge für NVMe bereit. Verwenden Sie sie, wenn das Dashboard fragwürdig ist, Sie aber weiterhin Belege zum Zustand des Laufwerks benötigen.

Wann Sie die Steckplatzzuordnung nicht bearbeiten sollten

Wenn das NVMe-Gerät in lspci und lsblkWenn das NVMe-Gerät in RAID recovery, ZimaCube 2, RAID oder ZimaCube nicht erkannt wird, liegt kein reines Problem der Benutzeroberfläche vor. Prüfen Sie zuerst BIOS, Sitz der Laufwerke, Steckplatzprotokoll, Stromversorgung und Hardwarekompatibilität. Eine Änderung der Steckplatzzuordnung kann ein physisch nicht erkanntes Laufwerk nicht sichtbar machen.

Der ZimaCube-2-Speicher und die RAID-Wiederherstellung bieten sicherere Referenzarchitekturen.

FAQ

Warum funktioniert mein Beelink-RAID, obwohl ZimaOS fehlende Laufwerke anzeigt?

Linux kann das RAID zusammenstellen und einhängen, auch wenn die visuelle Steckplatzzuordnung von ZimaOS nicht mit der PCI-Topologie des Beelink übereinstimmt.

Sollte ich das RAID neu erstellen, um fehlende NVMe-Karten zu beheben?

Nein. Wenn die Daten lesbar und das Array intakt ist, korrigieren oder melden Sie stattdessen die Zuordnung in der Benutzeroberfläche, anstatt ein funktionierendes Array zu zerstören.

Warum zeigt lsblk -o hctl nichts an?

NVMe-Geräte sind PCIe-Geräte, und die alte Umgehungslösung verwendete lspci-Adressen. HCTL ist für die Zuordnung von SCSI-/SATA-ähnlichen Geräten relevanter.

Kann ich nvme-cli weiterhin verwenden, wenn die ZimaOS-Benutzeroberfläche fehlerhaft ist?

Ja, sofern das Gerät unter Linux sichtbar ist. nvme smart-log kann Gesundheitszustand, Temperatur und Fehlerzähler unabhängig vom Dashboard bereitstellen.

Ist das Bearbeiten von local-storage.conf weiterhin der empfohlene erste Schritt?

Nein. Dies ist eine historische Umgehungslösung für Hardware, die nicht von Zima stammt. Testen Sie zuerst die aktuelle Version und sichern Sie die Konfiguration, bevor Sie manuelle Änderungen vornehmen.