Description
This test case creates a dual boot system with two Fedoras of different release versions, using btrfs snapshots, works as expected
Setup
- Fedora 36, any live desktop media, has been installed using default Automatic partitioning.
- Freshen your backups, just in case
Actions
Make snapshots
- Use the
df
command to find the/dev
node+partition for your/
mount point, e.g. $BTRFSPOOL = "/dev/nvme0n1p5" mount $BTRFSPOOL /mnt
; cd /mnt; ls -l- You should see two directories,
root
andhome
. These are Btrfs subvolumes, which we can snapshot. btrfs subvolume snapshot root root37
#any name will do
Create a bootloader entry using grubby
cd /boot/loader/entries;ls -l;grubby --default-kernel
- Duplicate the file matching the current default kernel (should be the most recent), e.g.
cp 64db766697e04179a6d3f7a67c2941e1-5.18.16-200.fc36.x86_64.conf 64db766697e04179a6d3f7a67c2941e1-5.18.16-200.fc36.x86_64-upgrade.conf
- Edit it
nano 64db766697e04179a6d3f7a67c2941e1-5.18.16-200.fc36.x86_64-upgrade.conf
- Add a recognizable change to the title such as appending UPGRADE to the line.
- Find the option
rootflags=subvol=root
changing it to match your snapshot, e.g.rootflags=subvol=root37
- Save the file
- Make it the default, use the filename of the configuration file, removing the
.conf* ending, e.g. 'grub2-set-default 64db766697e04179a6d3f7a67c2941e1-5.18.16-200.fc36.x86_64-upgrade
- Optional 1: After the system is upgraded, you can find this ~custom.conf file and delete it.
- Optional 2: You could choose to reveal the hidden GRUB menu, and edit the default entry, modifying
rootflags=subvol=root
to match the name you used for the snapshot, e.g.root37
. You'd do this twice: once to boot theroot37
snapshot to download the upgrade RPMs; and the following boot after that so it boots root37 thus initiating the offline upgrade.
Reboot
- Following boot, confirm
/
is actually using the snapshot you made:mount | grep btrfs
e.g.
/dev/vda3 on / type btrfs (rw,relatime,seclabel,compress=zstd:1,space_cache=v2,subvolid=257,subvol=/root)
you should see subvol=/root37
or whatever you named the snapshot. If you see root
as in this example, oops! You're still working on your original root, and need to figure out what went wrong.
One bootloader
As each Fedora performs updates, it'll occasionally update the bootloaders on /boot/efi
. This shouldn't be a problem. But then there's sometimes bugs, so if you don't want to be testing Rawhide bootloaders, consider addingexclude=grub2-*
in the test instance's dnf.conf
. The time to do this is after the first boot into root37
snapshot, before starting upgrade download.
Initiate the system upgrade
Either of these, just like you normally would:
- https://fedoraproject.org/wiki/QA:Testcase_upgrade_dnf_current_workstation
- https://fedoraproject.org/wiki/QA:Testcase_upgrade_gnome-software_current_workstation
Switching between the two roots
- You'll need to reveal the GRUB hidden menu to make manual choices, OR
ls -l /boot
to see a list of kernels so you can complete the path based on which release version you want to boot, e.g.grubby --set-default=/boot/vmlinuz-5.18.15-200.fc36.x86_64
to boot Fedora 36grubby --set-default=/boot/vmlinuz-5.19.0-65.fc37.x86_64
to boot Fedora 37
Limitations
/boot
is only 1GiB by default, so this is the limiting factor right now how many Fedoras you can have installed at one time. Two is safe. Three is iffy unless:
- configure the test Fedora instances' dnf.conf such
exclude=kernel-*
; - consider deleting the "rescue" initramfs and kernel for the test instances, and the "rescue" snippet in
/boot/loader/entries/
, and removingdracut-config-rescue-056-1.fc36.x86_64
from them so these files aren't recreated.
How to delete the test instance
- Boot the menu entry for the instance you want to keep
- Confirm you've booted it
mount | grep btrfs
does the subvolume name match what you want to keep? btrfs subvolume list -t /
##find the ID in the left column that matches the subvolume snapshot name you want to deletebtrfs subvolume delete --subvolid $ID /
##Note that/
is the mountpoint for the file system, it's not going to delete your currently running root, it'll delete the ID you specify.
Tip
The btrfs
command will accept arbitrarily shortened sub-commands so long as they're unambiguous: e.g. these commands are equivalent:
btrfs subvolume snapshot
,btrfs sub snap
,btrfs su sn
btrfs filesystem usage
,btrfs fi us
No configuration is needed, just try out your own shortened subcommands. If you make it too short, you'll get a hint why it's ambiguous.