Das Tutorial aus dem Jahr 2024 behandelte ein Kompatibilitätsproblem bei Anzeige und Zuordnung auf Hardware, die nicht von ZimaCube stammte. Es setzte voraus, dass das SATA- oder NVMe-Gerät bereits von Linux-Tools wie lsblk oder lspci erkannt werden konnte, ZimaOS das Layout des Drittanbieter-Controllers jedoch im Speicher-Shelf nicht korrekt zuordnete.
Diese Unterscheidung ist heute wichtig, da das aktuelle ZimaOS inzwischen mehrere Fixes für Speichergeräte von Drittanbietern erhalten hat. ZimaOS 1.4.4 behob ausdrücklich die fehlende Anzeige von NVMe-Festplatten von Drittanbietern im Speicherbereich, und 1.6.1 optimierte die Anzeige-Logik des Festplatten-Shelves für Drittanbietergeräte mit vielen Festplatten. Aktualisiere das System zuerst, bevor du die historische Konfigurationsdatei bearbeitest.
Der historische SATA-Fix verwendete SataStartNumber
Die offizielle Quelle wies SATA-Nutzer an, die Controller-Adressierung mit folgendem Befehl zu überprüfen:
lsblk -o hctlund bearbeite anschließend /etc/casaos/local-storage.conf also SataStartNumber stimmte mit der vom Gerät erwarteten HCTL-Nummerierung überein.
Der historische NVMe-Fix verwendete PCI-Adressen
Für NVMe-Geräte verwendete die Quelle lspci um PCI-Adressen zu ermitteln und trug sie in das NVME Feld derselben Konfigurationsdatei vor dem Neustart zimaos-local-storage.
Der Thread enthält einen tatsächlichen Streit über das Trennzeichen
Im offiziellen Text aus dem Jahr 2024 heißt es, dass mehrere NVMe-Adressen durch Kommas getrennt werden sollten. Im Oktober 2025 berichtete ein Community-Nutzer, dass Kommas auf seinem System nicht funktionierten, Leerzeichen hingegen schon.
Dieser Widerspruch sollte sichtbar bleiben. Er ist ein Hinweis darauf, dass sich das Format der manuellen Datei oder das Parserverhalten zwischen den Versionen geändert hat oder unterschiedlich war; er ist kein Grund, ein Trennzeichen für das aktuelle ZimaOS allgemein als korrekt zu erklären.
ZimaOS 1.4.4 fügte einen produktweiten Fix für NVMe-Festplatten von Drittanbietern hinzu
In den Versionshinweisen zu IceWhale 1.4.4 wird ausdrücklich erwähnt, dass die fehlende Anzeige von NVMe-Festplatten aus Drittanbietergeräten im Speicherbereich behoben wurde.
Siehe den offiziellen Fix für die NVMe-Anzeige von Drittanbietern.
ZimaOS 1.6.1: Anzeige großer Festplatten-Shelves von Drittanbietern weiter optimiert
IceWhale hat später die Anzeige-Logik für Festplatten-Shelves optimiert, wenn Drittanbietergeräte zu viele Festplatten enthalten. Das überschneidet sich direkt mit dem alten Problem der UI-Zuordnung und ist ein weiterer Grund, warum aktuelle Nutzer nicht mit der Bearbeitung einer Konfiguration aus dem Jahr 2024 beginnen sollten.
Zuerst feststellen, ob die Festplatte unter Linux fehlt oder nur in der Benutzeroberfläche nicht angezeigt wird
- Falls
lspci/lsblkWenn das Gerät nicht erkannt wird, untersuchen Sie Hardware, Controllermodus, Stromversorgung, Sitz der Komponenten und Treiberunterstützung. - Wenn Linux das Gerät erkennt, Storage es jedoch nicht, erfassen Sie die aktuelle ZimaOS-Version sowie Informationen zur Benutzeroberfläche und zum Speicherdienst.
Bearbeitungen von local-storage.conf als historisch/fortgeschritten behandeln
ZimaOS ist inzwischen ein unveränderlicheres Appliance-Betriebssystem als viele allgemeine Linux-Distributionen. Manuelle Bearbeitungen unter /etc kann versionsabhängig sein und durch spätere Aktualisierungen ersetzt werden. Bewahren Sie eine Kopie der Originaldatei auf und nutzen Sie die aktuellen Support-Hinweise, wenn die moderne Benutzeroberfläche Laufwerke weiterhin falsch erkennt.
Eine fehlende Laufwerkskachel ist nicht dasselbe wie ein fehlendes Laufwerk
Im Quell-Tutorial ging es hauptsächlich darum, wie Laufwerke von Drittanbietern in der ZimaOS-Speicheroberfläche angeordnet und angezeigt wurden. Wenn lsblk und Kernel-Protokolle ein Laufwerk erkennen, die Speicherseite es jedoch nicht korrekt anzeigt, unterscheidet sich das Problem von einem Controller oder Treiber, der die Festplatte überhaupt nicht erkennen kann.
Die Bearbeitung von local-storage.conf als historisch/fortgeschritten behandeln
Die Datei local-storage.conf vor der Bearbeitung sichern
Da OTA-Versionen inzwischen die Behandlung von Laufwerken von Drittanbietern geändert haben, kann ein alter, manuell bearbeiteter Wert nach einer Aktualisierung ebenfalls veraltet sein.
PCI-Adressen können sich ändern, wenn sich die Hardwaretopologie ändert
Das Verschieben einer NVMe-Karte in einen anderen Steckplatz, das Ändern einer PCIe-Bifurkationseinstellung oder die Aktualisierung der Plattform-Firmware kann die Enumeration der Geräte ändern. Eine fest codierte Adressliste gilt daher für diese Hardwaretopologie und nicht für das SSD-Modell selbst.
Die abweichenden Trennzeichenangaben der Quelle beibehalten
Die offiziellen Anweisungen von 2024 beschreiben durch Kommas getrennte NVMe-Adressen, während ein späterer Community-Nutzer angab, dass auf seinem System Leerzeichen funktionierten und Kommas nicht. Die Quellenlage reicht nicht aus, um die offizielle Syntax allgemein durch die Community-Variante zu ersetzen.
Aktualisieren Sie bei einer aktuellen Version zuerst und verwenden Sie das genaue Parser-Verhalten der aktuellen Version, bevor Sie das Feld bearbeiten.
Große Laufwerksgehäuse von Drittanbietern erhielten später Verbesserungen auf Produktebene
ZimaOS 1.6.1 verbesserte ausdrücklich das Anzeigeverhalten für Geräte von Drittanbietern mit einer größeren Anzahl von Laufwerken. Benutzer mit HBA-Karten, Gehäusen mit mehreren Einschüben oder mehr als sechs Laufwerken sollten das Problem daher zunächst in der aktuellen Version reproduzieren, bevor sie veraltete Einstellungen zur Nummerierung des Laufwerksgehäuses ändern.
FAQ zur Anzeige von Laufwerken von Drittanbietern
Bedeutet ein im ZimaOS-Laufwerksgehäuse fehlendes Laufwerk, dass Linux es nicht erkennen kann?
Nein. Das ursprüngliche Tutorial befasste sich ausdrücklich mit Fällen, in denen die Hardware vorhanden war, aber die Zuordnung in der Benutzeroberfläche falsch war.
Hat ZimaOS später offizielle Fehlerbehebungen hinzugefügt?
Ja. 1.4.4 behob das Problem, dass NVMe-Laufwerke von Drittanbietern als fehlend angezeigt wurden, und 1.6.1 optimierte die Anzeige von Laufwerksgehäusen von Drittanbietern.
Sollten aktuelle Benutzer SataStartNumber oder NVME blind bearbeiten?
Nein. Aktualisieren Sie zuerst und bestätigen Sie die aktuelle Fehlerquelle.
