Skip to content

Updates

Getting back to revisions, these can be modified and upgraded, thus creating a new revision of the device.

Updates will be processed differently depending on the source being remote or local.

Pantavisor will report the update state from the moment the update is acknowledged until it is finished. Pantavisor will only progress to the new revision in case of success. Otherwise, no action or rollback will ensue, depending on the point where the error is detected. This is the list of update states:

QUEUED

Only valid for remote updates.

Pantavisor has got the state JSON of the new revision, but is performing other operations and has put it to the queue to be processed later.

DOWNLOADING

Only valid for remote updates.

Downloading the artifacts for the new revision.

INPROGRESS

Installing or progressing to this revision. Transitions to new revisions can either require a reboot or not.

To finish this state, it is necessary that all conditions existing in the new revision have been met. Also, in the case of a remote update, Pantavisor needs to have achieved communication with Pantacor Hub. If these two conditions are not met with a configurable time, Pantavisor will rollback the update.

Reboot transition

Reboot transitions are performed after an update that contains changes in the root of the status JSON, in the BSP or any of the containers that belong to data, root or platform groups.

In this case, Pantavisor will stop all the containers and reboot the board.

Non-reboot transition

Non-reboot transitions are performed after an update that does not contain any changes in any of the components described for the reboot updates.

In this case, Pantavisor will only stop the containers that were affected by the update and restart them with the new revision artifacts.

TESTING

Waiting to see if the revision is stable. During this stage, Pantavisor checks if all containers are running and will rollback if any of them exits. Besides that, in the case of a remote update, it will also rollback in case Pantacor Hub communication is lost.

UPDATED

The revision is stable, but the update did not need a board reboot, so the rollback point is not set until you force a reboot.

DONE

The revision has been fully booted and is stable. The rollback point is set.

WONTGO

The new revision cannot be parsed because of a bad state JSON format, so it is aborted.

ERROR

The new revision failed during INPROGREES or TESTING stages. Pantavisor will try to rollback to the latest DONE revision.