Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describes how to update GridOS on existing Grid devices.

Raspberry PI4

Requirements

  • At least

    GridOS

    v0

    v.

    8.6 for arm64: GridOS-v0.8.6-arm64.

    0.9.0+. The over-the-air OS update is supported from this version and higher

    , for RPI4

    . Lower versions will not have OTA OS update support

  • Latest omg utility. If you hav existing omg utility installed, do omg update , or npm install -g @ombori/ga-cli

  • Instructions

  • flash the minimum required RPI4 (arm64) GridOS version to your SD Card  GridOS-v0.8.6-arm64. Checkout in the Device Set-up flow in the Grid Console for the newer versions

  • Set the device agent module to at least v1.5.0 and up, in console

    Image Removed
  • once the device is online and running, run omg dev stream <devicename> agent update '{version: "0.9.0"}' . This will download the newer OS to your storage.
    Once you see zfs send -R update/ROOT/gridos.0.9.0@installed line, you can exist the cli session.
    Image Removedor run zfs list -t snapshot | grep install to verify. First connect to the device shell, omg dev shell <device-name>
    Image Removed

  • then run omg dev stream <devicename> agent install '{version: "0.9.0"}' to instruct the device to install latest the version. verify that the logs does not show errors:

    Image Removed
  • finally, reboot the device through shell, omg dev shell <device_name>. If you’re in terminal and the UI menu is closed, run omborictl, the menu should show.

  • in the menu, select reboot

  • when device is rebooted, the network settings is reset. configure the network again

  • after network is configured, the device should load the associated app on the screen
  • Agent module v.1.5.4+

Instructions

Select desired Grid OS version in the drop-down list of the agent module.

...

The update will be downloaded and applied automatically. The new version will be used on next device reboot. The download will start immediately after the setting is changed. In case download have failed, the next download attempt will be scheduled in an hour.

Monitoring status

Currently you can check the status of the update in agent module telemetry, using omg dev modules <devicename> command.

...

  • current stays for currently active GridOS version

  • downloaded stays for the version that was downloaded, but not installed

  • pending is a version that will be installed on next reboot

  • error indicates there was an error with download