Repository navigation
elevate: Document the upgrade entry not booted with GRUB_DEFAULT != saved - #883
Merged
andrewlukoshko merged 1 commit intoNov 12, 2026
Conversation
…aved Add a Frequent Issues section for systems where GRUB_DEFAULT in /etc/default/grub is not "saved" (e.g. GRUB_DEFAULT=0 in cloud images): on EL8 and EL9 the ELevate-Upgrade-Initramfs entry is saved as the default one, but GRUB ignores the saved entry and boots the regular kernel, so the upgrade never starts. Describe how to check the setting, the workaround (GRUB_DEFAULT=saved and grub2-mkconfig), and how to boot the upgrade entry once with grub2-reboot when the system was already rebooted into the old kernel. Link the section from the Quickstart Guide. Related: AlmaLinux/leapp-repository#158
andrewlukoshko
approved these changes
Nov 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a Frequent Issues entry for systems where
GRUB_DEFAULTin/etc/default/grubis notsaved, for exampleGRUB_DEFAULT=0from a cloud image or provider template.On EL8 and EL9 based systems
leapp upgradesaves theELevate-Upgrade-Initramfsentry as the default one, but GRUB ignores the saved entry with such a setting and boots the regular kernel, so the upgrade never starts.Changes:
ELevate-Upgrade-Initramfsentry" with the symptom, how to check the setting, the explanation, and two workarounds:GRUB_DEFAULT=savedand regenerate the GRUB configuration beforeleapp upgrade;grub2-rebootwhen the system has already been rebooted into the old kernel.The issue was reproduced on a CentOS 7.9 -> AlmaLinux 8.10 -> AlmaLinux 9.8 upgrade chain (UEFI), and the
grub2-rebootworkaround was verified there.Related: AlmaLinux/leapp-repository#158