Communityoplossing

ZimaOS op ZimaCube bijwerken via de CLI: historische RAUC-workflow versus de huidige offline-updateprocedure

A December 2024 ZimaCube post explaining how to download a 1.3.0-2 RAUCB into the old offline-update folder because the author's Cube did not see the OTA prompt. IceWhale later advised waiting for the normal update prompt. Current ZimaOS documentation has changed the offline package location since v1.4.1.

De brontekst is nuttig omdat deze laat zien hoe offline updates van ZimaOS werkten tijdens het 1.3.x-tijdperk, maar het letterlijke pad en de bestandsnaam van het pakket zijn verouderd. De auteur downloadde een ZimaCube-specifieke .raucb-bundel naar een map voor offline updates, zodat het systeem deze kon vinden en de update-indicator kon weergeven.

Het huidige ZimaOS ondersteunt nog steeds OTA- en offline RAUC-updates, maar in de actuele documentatie van IceWhale staat expliciet dat de locatie van het offline pakket vanaf v1.4.1 is gewijzigd. Huidige algemene x86-releases gebruiken ook architectuurgerichte pakketnamen, zoals zimaos-x86_64-.... Kopieer de URL van 2024 voor 1.3.0-2 of de oude map niet zomaar naar een systeem uit 2026 zonder de actuele release-instructies te controleren.

De bron downloadde in 2024 handmatig een RAUCB

De auteur van de bron ging naar de officiële ZimaOS-releases op GitHub, kopieerde de toenmalige URL van de ZimaCube-.raucb en downloadde deze via SSH naar de map voor offline updates.

De verwachting was dat ZimaOS de map zou scannen en de rode update-indicator zou weergeven, soms na een herstart.

IceWhale gaf de voorkeur aan de normale OTA-melding zodra die verscheen

Zima-Giorgio antwoordde dat het ook mogelijk was om het handmatig gedownloade bestand te verwijderen en te wachten tot het systeem de gebruiker over de update zou informeren. Dit laat zien dat de handmatige methode uit de bron een alternatief was wanneer OTA-detectie niet verscheen, en niet de enige ondersteunde updatemethode.

De locatie van het offline pakket veranderde na ZimaOS 1.4.1

In de actuele documentatie van IceWhale staat:

  • oudere releases vóór 1.4.1 gebruikten de oudere RAUC-locatie voor offline updates;
  • v1.4.1 en later gebruiken de nieuwere locatie .ota/offline op ZimaOS-HD.

Gebruik de actuele workflow voor offline updates van ZimaOS in plaats van ervan uit te gaan dat het pad uit 2024 permanent is.

Kies de bundel voor de architectuur van de huidige hardware

Een latere thread uit 2026 liet zien waarom oude, hardgecodeerde download-URL's mislukken: een gebruiker kreeg een 404 van een oude mirror en downloadde uiteindelijk de huidige x86_64-RAUCB uit de officiële GitHub-release.

Gebruik altijd het asset dat is gepubliceerd voor jouw huidige ZimaOS-release en hardware, in plaats van alleen het versienummer in een oude URL te wijzigen.

Voor zeer oude ZimaOS-releases kan een tussenupgrade nodig zijn

IceWhale heeft herhaaldelijk gevallen gedocumenteerd waarin systemen onder 1.2.5 eerst naar 1.2.5 moesten upgraden voordat ze naar een veel nieuwere release konden gaan. Dit is vooral relevant voor vroege ZimaCube-eenheden die al jaren niet zijn bijgewerkt.

Forceer geen moderne RAUCB op een zeer oude systeemslot als de actuele richtlijnen van IceWhale een tussenversie voorschrijven.

Een directe installatie met rauc is een geavanceerde methode

Medewerkers van IceWhale hebben rauc install <bundle> gebruikt in officiële probleemoplossings- en testdriverworkflows. Dat betekent niet dat elke reguliere update de gebruikersinterface en het mechanisme voor het scannen van pakketten moet omzeilen.

Voor normale systemen biedt de actuele workflow voor offline updates een duidelijker ondersteund pad en zichtbare statusinformatie.

RAUC-updates zijn afhankelijk van het dual-slot-herstelmodel van ZimaOS

ZimaOS beheert systeemslots, zodat een mislukte update kan worden geïsoleerd van gebruikersgegevens en, in ondersteunde herstelsituaties, het andere slot kan opstarten. Wis of formatteer geen systeempartities alleen omdat een update niet onmiddellijk verschijnt.

Controleer de nieuwe versie na het opnieuw opstarten

Bevestig na het voltooien van de update de weergegeven ZimaOS-versie, test Bestanden/Opslag, controleer belangrijke apps en bevestig externe en netwerktoegang. Als de update als geslaagd wordt gemeld maar de versie niet verandert, verzamel dan de updatefout of -status in plaats van dezelfde bundel herhaaldelijk opnieuw te installeren.

Veelgestelde vragen over offline updates van ZimaOS

Moeten huidige gebruikers het ZimaCube-pakket 1.3.0-2 uit de bron downloaden?

Nee. Dat pakket en die URL zijn verouderd.

Ondersteunt het huidige ZimaOS nog steeds offline updates?

Ja. IceWhale onderhoudt een actuele workflow voor offline updates met RAUCB-pakketten.

Is de map voor offline pakketten na v1.4.1 gewijzigd?

Ja. In de actuele documentatie van IceWhale staat expliciet dat het pad vanaf v1.4.1 is gewijzigd.