Recovery

From Halon, SMTP software for hosting providers
Jump to: navigation, search

You probably read this article because something went wrong with your configuration. You have several options, depending on what have happened, and what you like to do.

Method Authentication Reboot Deletes all data
Rollback using HTTPS Password No No
Rollback using console Password No No
Rollback during boot Console access Yes No
Factory reset Console access Yes Yes

Rollback using HTTPS

  1. Go to the Configuration > Revision management
  2. Select a previous (known working) revision (so that the line highlights in blue)
  3. Press "Rollback"

Rollback using console

  1. Login to the console
  2. Navigate to the configuration menu, select the desired revision, and press "R"

Rollback during boot

Interrupting the boot to perform recovery operations
  1. Connect to the console (video or serial)
  2. Reboot (possibly by powering off)
  3. Do not press any keys when the firmware prompt appears
  4. Wait for it to start booting (takes about a minute)
  5. When you see Press any key for recovery..., do so (press any key)
  6. Run default-config which will commit a new configuration revision
  7. Run boot to boot with the new, default configuration
  8. Once logged in with the default username and password (admin) you can rollback to a known working configuration as described previously

Stuck in recovery (update) partition

If the Halon system isn't rebooted properly after the recovery partition's update instruction is written, it gets stuck with the error

mount /cfg: Operation not permitted

because the recovery partition doesn't perform an fsck before mounting. It is fixed by rebooting (by typing reboot), pressing any key when it says "Hit [Enter] to boot..." and typing at the prompt

unload
lsdev
set currdev=disk0s3a
include /boot/loader.rc
boot 

which will boot the normal system partiton, that will repair the configuration partition (with fsck). You can watch the procedure in this video.