You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/operation/upgrade-recovery.rst
+12-6Lines changed: 12 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,38 +13,42 @@ version after a failed upgrade.
13
13
* :ref:`Configuration: <configuration>` How to enable upgrade recovery
14
14
* :ref:`How it Works: <how_it_works>` Overview of the recovery process
15
15
* :ref:`Cancelling Recovery: <cancelling_recovery>` Overview of the recovery
16
-
process
16
+
process
17
17
18
18
.. _configuration:
19
19
20
20
*************
21
21
Configuration
22
22
*************
23
23
.. warning:: Upgrade recovery is disabled by default. To use it,
24
-
**enable it first**.
24
+
**enable it first**.
25
25
26
26
To enable upgrade recovery, run the following command:
27
27
28
28
.. cfgcmd::
29
29
30
30
set system option reboot-on-upgrade-failure [timeout <min>]
31
31
32
-
* ``timeout <min>:`` The time in minutes (5 - 30) you have to cancel upgrade recovery. See :ref:`Cancelling Recovery <cancelling_recovery>`.
32
+
* ``timeout <min>:`` The time in minutes (5 - 30) you have to cancel upgrade
33
+
recovery. See :ref:`Cancelling Recovery <cancelling_recovery>`.
33
34
34
35
.. _how_it_works:
35
36
36
37
************
37
38
How it Works
38
39
************
39
-
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:
40
+
After a VyOS upgrade, the system monitors the boot process. Upon detecting a
41
+
boot failure, VyOS initiates a revert to the last working version and displays
42
+
the following warning:
40
43
41
44
.. code-block:: none
42
45
43
46
Booting failed, reverting to previous image
44
47
Automatic reboot in xx minutes
45
48
Use "reboot cancel" to cancel
46
49
47
-
If no action is taken, the reboot happens automatically after the configured timeout. Upon successful recovery and reboot, the following message appears:
50
+
If no action is taken, the reboot happens automatically after the configured
51
+
timeout. Upon successful recovery and reboot, the following message appears:
48
52
49
53
.. code-block:: none
50
54
@@ -58,7 +62,9 @@ If no action is taken, the reboot happens automatically after the configured tim
58
62
*******************
59
63
Cancelling Recovery
60
64
*******************
61
-
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.
65
+
Upon detecting a boot failure, you have the predefined timeout to cancel
66
+
upgrade recovery. This is useful if you want to troubleshoot the faulty VyOS
67
+
version on your own.
62
68
63
69
To cancel upgrade recovery, run the following command:
0 commit comments