Communityoplossing

Ontbrekende SATA- of NVMe-schijven herstellen op ZimaOS-hardware van derden: historisch local-storage.conf versus huidige releases

An October 2024 IceWhale tutorial for third-party x86 systems where disks existed in Linux but appeared incorrectly or were missing from ZimaOS storage UI. It used local-storage.conf to map SATA starting numbers and NVMe PCI addresses. Later releases added direct third-party NVMe and disk-shelf fixes, and a community reply found spaces worked better than the original comma-separated NVMe example.

De brontutorial uit 2024 behandelde een compatibiliteitsprobleem met de weergave/toewijzing op hardware die niet van ZimaCube was. Er werd van uitgegaan dat het SATA- of NVMe-apparaat al zichtbaar was in Linux-hulpprogramma's zoals lsblk of lspci, maar dat de opslagplank van ZimaOS de indeling van de controller van derden niet correct toewijsde.

Dat onderscheid is vandaag van belang, omdat het huidige ZimaOS sindsdien verschillende oplossingen voor opslag van derden heeft gekregen. In ZimaOS 1.4.4 werd expliciet opgelost dat NVMe-schijven van derden in Opslag als ontbrekend werden weergegeven, en in 1.6.1 werd de weergavelogica van de schijfplank geoptimaliseerd voor machines van derden met veel schijven. Werk eerst bij voordat je het historische configuratiebestand bewerkt.

Bij de historische SATA-oplossing werd SataStartNumber gebruikt

De officiële bron adviseerde SATA-gebruikers de controlleradressering te controleren met:

lsblk -o hctl

en bewerk vervolgens /etc/casaos/local-storage.conf dus SataStartNumber kwam overeen met de HCTL-nummering die de machine verwachtte.

ZimaOS-terminal met lsblk HCTL-uitvoer naast local-storage.conf, met SataStartNumber gemarkeerd
De workaround uit de bron wijzigde de toewijzingslogica van de ZimaOS-gebruikersinterface nadat de nummering van de SATA-controller was bevestigd.

Bij de historische NVMe-oplossing werden PCI-adressen gebruikt

Voor NVMe-apparaten gebruikte de bron lspci om PCI-adressen te identificeren en plaatste deze in het NVME veld van hetzelfde configuratiebestand voordat je opnieuw opstart zimaos-local-storage.

ZimaOS-terminal met meerdere NVMe-PCI-adressen en de NVME-regel in local-storage.conf
In de oorspronkelijke handleiding werden PCI-adressen gebruikt om de opslaginterface te laten weten waar NVMe-apparaten van derden zich bevonden.

In de discussie bestaat een echte onenigheid over het scheidingsteken

In de officiële tekst uit 2024 staat dat meerdere NVMe-adressen met komma's moeten worden gescheiden. In oktober 2025 meldde een gebruiker uit de community dat komma's niet werkten op diens systeem en spaties wel.

Deze tegenstrijdigheid moet zichtbaar blijven. Ze vormt bewijs dat de indeling van het handmatige bestand of het parsergedrag tussen versies is gewijzigd of verschilde; het is geen reden om één scheidingsteken universeel correct te verklaren voor het huidige ZimaOS.

ZimaOS 1.4.4 voegde een NVMe-oplossing op productniveau voor apparaten van derden toe

In de releaseopmerkingen van IceWhale voor versie 1.4.4 staat expliciet dat NVMe-schijven van apparaten van derden die in Opslag als ontbrekend werden weergegeven, zijn gerepareerd.

Zie de officiële oplossing voor de weergave van NVMe-schijven van derden.

ZimaOS 1.6.1 heeft grote schijfplanken van derden verder geoptimaliseerd

IceWhale heeft later de weergavelogica van de schijfplank geoptimaliseerd wanneer apparaten van derden te veel schijven bevatten. Dat overlapt rechtstreeks met het oude probleem met de toewijzing in de gebruikersinterface en is nog een reden waarom huidige gebruikers niet moeten beginnen met het bewerken van een configuratie uit 2024.

Bepaal eerst of de schijf ontbreekt in Linux of alleen in de gebruikersinterface

  • Als lspci/lsblk Als het apparaat niet zichtbaar is, onderzoek dan de hardware, controllermodus, voeding, plaatsing en ondersteuning van het stuurprogramma.
  • Als Linux het apparaat wel ziet, maar Opslag niet, verzamel dan de huidige ZimaOS-versie en gegevens over de UI en de opslagservice.

Beschouw bewerkingen van local-storage.conf als historisch/geavanceerd

ZimaOS is nu een meer immutable appliance-OS dan veel algemene Linux-distributies. /etc kan versieafhankelijk zijn en door latere updates worden vervangen. Bewaar een kopie van het oorspronkelijke bestand en volg de actuele supportinstructies als de moderne UI schijven nog steeds verkeerd identificeert.

Een ontbrekende schijftegel is niet hetzelfde als een ontbrekende schijf

De brontutorial ging voornamelijk over de manier waarop schijven van derden werden gerangschikt en weergegeven in de Opslaginterface van ZimaOS. Als lsblk en de kernel-logboeken een schijf zien, maar de pagina Opslag deze niet correct weergeeft, is het probleem anders dan bij een controller of stuurprogramma dat de schijf helemaal niet kan detecteren.

Maak een back-up van local-storage.conf voordat je dit bewerkt

Bij de historische methode wordt een oorspronkelijk ZimaOS-configuratiebestand aangepast. Sla het oorspronkelijke bestand eerst op en noteer de huidige ZimaOS-versie, zodat je kunt terugkeren als de schijfbehuizing na de wijziging slechter wordt weergegeven.

Omdat OTA-releases sindsdien de verwerking van schijven van derden hebben gewijzigd, kan een oude handmatig bewerkte waarde na een update ook verouderd raken.

PCI-adressen kunnen veranderen wanneer de hardwaretopologie verandert

Als je een NVMe-kaart naar een andere sleuf verplaatst, een PCIe-bifurcatie-instelling wijzigt of de firmware van het platform bijwerkt, kan dit veranderen hoe apparaten worden opgesomd. Een hardgecodeerde adreslijst hoort daarom bij die hardwaretopologie, niet bij het SSD-model zelf.

Behoud het meningsverschil over het scheidingsteken in de bron

De officiële instructies uit 2024 beschrijven NVMe-adressen, gescheiden door komma's, terwijl een latere gebruiker uit de community aangaf dat spaties op diens systeem werkten en komma's niet. Er is onvoldoende bronbewijs om de officiële syntaxis universeel te vervangen door de variant uit de community.

Werk in een huidige release eerst bij en gebruik het exacte parsergedrag van die versie voordat je het veld aanpast.

Grote schijfbehuizingen van derden kregen later verbeteringen op productniveau

ZimaOS 1.6.1 verbeterde specifiek de weergave voor apparaten van derden met grotere aantallen schijven. Gebruikers met HBA-kaarten, behuizingen met meerdere sleuven of meer dan zes schijven moeten het probleem daarom eerst reproduceren in de huidige release voordat ze verouderde instellingen voor het aantal schijven in de behuizing wijzigen.

Veelgestelde vragen over de weergave van schijven van derden

Betekent een ontbrekende schijf in de ZimaOS-schijfbehuizing dat Linux deze niet kan zien?

Nee. De oorspronkelijke handleiding behandelde specifiek gevallen waarin de hardware aanwezig was, maar de UI-koppeling onjuist was.

Heeft ZimaOS later officiële oplossingen toegevoegd?

Ja. 1.4.4 verhielp dat NVMe-schijven van derden als ontbrekend werden weergegeven, en 1.6.1 optimaliseerde de weergave van schijfbehuizingen van derden.

Moeten huidige gebruikers zomaar SataStartNumber of NVME aanpassen?

Nee. Werk eerst de huidige foutlaag bij en bevestig deze.