Difference between revisions of "Manual Node Recovery Guide"

From Internet Computer Wiki
Jump to: navigation, search
m
m (Add disclaimer)
Line 1: Line 1:
 
🚧🚧🚧 UNDER CONSTRUCTION 🚧🚧🚧
 
🚧🚧🚧 UNDER CONSTRUCTION 🚧🚧🚧
 +
 +
'''⚠️⚠️⚠️ Disclaimer:''' Do not attempt this unless you are certain it is appropriate. Manual node recovery should only occur in the event of a critical IC failure. In such cases, the process will be coordinated by reputable community members and discussed publicly with node providers.
 +
 +
and it is being actively discussed or recommended in trusted community forums.
  
 
===1. Receive recovery version and short hash===
 
===1. Receive recovery version and short hash===

Revision as of 13:58, 4 September 2025

🚧🚧🚧 UNDER CONSTRUCTION 🚧🚧🚧

⚠️⚠️⚠️ Disclaimer: Do not attempt this unless you are certain it is appropriate. Manual node recovery should only occur in the event of a critical IC failure. In such cases, the process will be coordinated by reputable community members and discussed publicly with node providers.

and it is being actively discussed or recommended in trusted community forums.

1. Receive recovery version and short hash

A recovery coordinator will notify all subnet Node Providers of the recovery image version and associated short (6-character) hash that Node Providers will use to apply the upgrade

2. Complete Recovery

Note that the recovery can be completed from the node's remote BMC console view or from the physical console

  1. Reboot the machine
  2. During reboot, at the grub menu, press 'e' to edit the boot parameters (you must press 'e' before the 15-second timeout)
    If you miss the timeout, don't worry. Just reboot the machine and try again.
    screenshot
  3. From the GRUB edit mode screen, add the boot parameters: recovery=1 version=ABC hash=XYZ (replace ABC and XYZ with the version and hash provided by the recovery coordinator. Note that the hash should only be six-characters long.)
    screenshot
    →→→
    screenshot
    🚧 Do not follow the screenshot's version and hash values! Use the version and hash values provides by the recovery coordinator! 🚧
  4. Press ctrl-X or F10 to boot

3. Wait for recovery confirmation

...