Rollback
JFrog Connect Agent supervises your device and wraps your updates in a Rollback engine, which is able to revert any update to the previous state, allowing the device's software to be 100% reliable.
All Action Blocks have On Fail configurations in addition to the Action configuration.
When an Action Block fails to run or raises an exception, the Action Blocks "On Fail" is triggered. The "On Fail" configuration contains the Continue Update Flow checkbox, the Run General Rollback checkbox, and in some Blocks a Do Action section.
After the "On Fail" finishes the Update exits.
Default - unchecked. If checked, the Update will continue as if the Action Block succeeded. In the Deployment Output you will still see that the Action Block failed and the error that caused the failure. When checked, all other On Fail options are deselected.
Default - checked. If checked, the Update will trigger the General Rollback Block if the Action fails. * The General Rollback will run after the On Fail Actions of all blocks have finished.
Default - unchecked. This section defines an additional rollback action to preform when the action fails. You can choose one of two options - Whole Update Fails or This Action Fails Only. Whole Update Fails*Requires Agent Version 6.0 or above.The rollback action will run if any actions after the current action fail (including the current action).This Actions Fails OnlyThe rollback action will run only if the current action failed.Revert FilesReverts all files/containers changed in the block, to their previous state. The rollback actions run in the same order as the Action Blocks.
We highly recommend adding General Rollback to each Update Flow. The General Rollback runs only if the update fails and the Action Block that failed had the Run General Rollback checked.
The purpose of the General Rollback is to ensure that no matter what your application will always be able to return to a stable and running state.