mirror of
https://github.com/vyos/vyos-documentation.git
synced 2025-12-15 18:12:02 +01:00
bc7512c2c7
* Proofread boot-options.rst * Fix line length Markdown lint errors * Proofread information.rst * Update lastproofread date in information.rst * Updated password-recovery.rst * Proofread upgrade-recovery.rst * Fix line length linting errors * Proofread up to Empty 2+ Disk * Complete proofread of raid.rst * Update upgrade-recovery timeout explanation * Fix header formatting * Update docs/operation/boot-options.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add missing period in raid.rst * Implement Copilot feedback --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Daniil Baturin <daniil@baturin.org>
74 lines
2.0 KiB
ReStructuredText
74 lines
2.0 KiB
ReStructuredText
:lastproofread: 2025-11-20
|
|
|
|
.. _upgrade_recovery:
|
|
|
|
|
|
##############################
|
|
Recovery after Failed Upgrades
|
|
##############################
|
|
|
|
Use **VyOS upgrade recovery** to restore the system to the last working
|
|
version after a failed upgrade.
|
|
|
|
* :ref:`Configuration: <configuration>` How to enable upgrade recovery
|
|
* :ref:`How it works: <how_it_works>` Overview of the recovery process
|
|
* :ref:`Cancelling recovery: <cancelling_recovery>` Overview of the recovery
|
|
process
|
|
|
|
.. _configuration:
|
|
|
|
*************
|
|
Configuration
|
|
*************
|
|
.. warning:: Upgrade recovery is disabled by default. To use it,
|
|
**enable it first**.
|
|
|
|
To enable upgrade recovery, run the following command:
|
|
|
|
.. cfgcmd::
|
|
|
|
set system option reboot-on-upgrade-failure [timeout <min>]
|
|
|
|
* ``timeout <min>:`` The time in minutes (5 - 30) to cancel upgrade
|
|
recovery before VyOS reboots.
|
|
See :ref:`Cancelling Recovery <cancelling_recovery>`.
|
|
|
|
.. _how_it_works:
|
|
|
|
************
|
|
How it works
|
|
************
|
|
After a VyOS upgrade, the system monitors the boot process. Upon detecting a
|
|
boot failure, VyOS initiates a revert to the last working version and displays
|
|
the following warning:
|
|
|
|
.. code-block:: none
|
|
|
|
Booting failed, reverting to previous image
|
|
Automatic reboot in xx minutes
|
|
Use "reboot cancel" to cancel
|
|
|
|
If no action is taken, the reboot happens automatically after the configured
|
|
timeout. Upon successful recovery and reboot, the following message appears:
|
|
|
|
.. code-block:: none
|
|
|
|
WARNING: Image update to "VyOS 1.5.xxxx" failed
|
|
Please check the logs:
|
|
/usr/lib/live/mount/persistence/boot/NAME/rw/var/log
|
|
Message is cleared on next reboot!
|
|
|
|
.. _cancelling_recovery:
|
|
|
|
*******************
|
|
Cancelling recovery
|
|
*******************
|
|
Upon detecting a boot failure, you have the predefined timeout to cancel
|
|
upgrade recovery. This is useful if you want to troubleshoot the faulty VyOS
|
|
version on your own.
|
|
|
|
To cancel upgrade recovery, run the following command:
|
|
|
|
.. code-block:: none
|
|
|
|
reboot cancel |