#685 [main] Doc issue in file modules/ROOT/pages/upgrading-fedora-offline.adoc
Opened 4 months ago by urilabob. Modified 3 months ago

Section "Update Rescue Kernel" contains the following advice:

If the rescue kernel is out-of-date, then issue the following commands to regenerate it.
sudo rm /boot/rescue
sudo kernel-install add "$(uname -r)" "/lib/modules/$(uname -r)/vmlinuz"

This advice is pretty dangerous. If the rescue kernel has failed to be updated, the most likely reason is that an error is occurring in generating the updated kernel. In my case, the root cause (after a few levels of consequences) was a known problem with the boot install process in F39. Following the advice in the documentation left me with a system with no installed kernel (I actually hesitated before doing this, but laziness won out). Fortunately, documentation tracing appears to have found the appropriate fixes - not yet tested by reboot, though).

New users following this advice may well be left with no rescue kernel (and possibly no idea that that has happened), or at worst a bricked system (no kernel -- which may not be obvious until the next reboot), and no idea how to unbrick it. This needs to be fixed. The obvious fix is to put the new kernel install first. Then give the user some pointers on how to check whether the install succeeded, and where to look if it fails. Only after the install has succeeded should the old rescue kernels be removed. It makes the line to remove the old rescue kernels a bit more complex, but it's a helluva lot safer.

Note: there may be a temptation to treat this as just a consequence of the bug underlying the known problem with the boot install process in F39, and leave it to that process. However even if that problem gets fixed, the underlying problem remains: removing the old rescue kernels before making sure that the new rescue kernel can be generated is too dangerous.


OK, looks like there is a misunderstanding on my part: it seems that the new rescue kernel is only generated if there is no rescue kernel there. Perhaps, then, it needs to be a three-step process:


  1. Move the old rescue kernels somewhere safe

  2. Generate the new rescue kernel

  3. If the kernel is successfully generated, remove the old rescue kernels, otherwise replace the old rescue kernels and try to diagnose what went wrong

Please, may I ask you to create a proposal for a correct wording? I guess I'm not familiar enough with the topic. So a proposal would be very helpfull. The easiest way for me would be a Pull Request (PR), But if you are not familiar with git, please include it in a comment.

Thanks a lot.

Login to comment on this ticket.

Metadata