From Fedora Project Wiki
(mention /boot(/efi), simplify and clarify subvolumes instructions) |
(template tweak again...) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
|description= This test case ensures that the data in the `/home` directory is retained and usable on a [[Btrfs]] layout after another Fedora is installed on the same partition. | |description= This test case ensures that the data in the `/home` directory is retained and usable on a [[Btrfs]] layout after another Fedora is installed on the same partition. | ||
|setup= | |setup= | ||
{{Template:Partitioning_single_setup}} | |||
{{Template:Partitioning_preserve_home_setup}} | |||
|actions= | |actions= | ||
{{Template:partitioning_actions}} | {{Template:partitioning_actions}} | ||
# In Installation Destination, use ''Advanced Custom (Blivet-GUI)'' partitioning | # In Installation Destination, use ''Advanced Custom (Blivet-GUI)'' partitioning | ||
| Line 15: | Line 14: | ||
# Create a new `root` subvolume and set the `/` mountpoint to it. | # Create a new `root` subvolume and set the `/` mountpoint to it. | ||
#* If you already have a `root` subvolume, because you decided to not delete the old one, that's not a problem, just name the new one differently. | #* If you already have a `root` subvolume, because you decided to not delete the old one, that's not a problem, just name the new one differently. | ||
{{Template:partitioning_actions_post}} | |||
{{Template:partitioning_preserve_home_post}} | |||
|results= | |results= | ||
{{Template: | {{Template:Partitioning_preserve_home_results}} | ||
}} | }} | ||
[[Category:Installer_Partitioning_Test_Cases]] | [[Category:Installer_Partitioning_Test_Cases]] | ||
[[Category:btrfs]] | [[Category:btrfs]] | ||
Latest revision as of 00:36, 14 February 2024
Associated release criterion
This test case is associated with the Fedora_42_Beta_Release_Criteria#Custom_partitioning release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.
This test case is associated with the Fedora_42_Beta_Release_Criteria#Custom_partitioning release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.
Description
This test case ensures that the data in the /home directory is retained and usable on a Btrfs layout after another Fedora is installed on the same partition.
Setup
- Prepare a test system with a working, supported storage device of sufficient size for a Fedora install, and a Fedora installation medium that uses the GTK-based installer. Do not use Fedora Workstation live on Fedora 41+, as that uses the webui-based installer.
- Install Fedora 41 or 42 from any Edition or Spin which uses Btrfs filesystem by default. Ensure a separate /home subvolume is created. If you are installing to at least 50 GB of free space, this will happen if you use Automatic storage configuration during disk partitioning; otherwise, you will have to use custom partitioning and ensure a separate /home subvolume is created.
- On the installed system, create some distinct files and directories in your home directory or directly in
/home.
How to test
- Boot the GTK-based installer using any available means. Do not use Fedora Workstation live on Fedora 41+, as that uses the webui-based installer.
- Proceed to the installer's main screen, making sensible choices, and enter the Installation Destination screen.
- In Installation Destination, use Advanced Custom (Blivet-GUI) partitioning
- On the disk drive containing the existing Fedora installation, make sure the existing partitions formerly used as
/bootand/boot/efi(if applicable) are reformatted and the same mountpoints are again assigned to them. (Alternatively, you can create new partitions and leave the old ones intact and without mountpoints). - In the list of existing btrfs volumes, locate the
homesubvolume of the existing installation and set the/homemountpoint to it. - You can delete all the other btrfs subvolumes, or you can keep them intact, but without any mountpoints assigned.
- This refers to the
rootsubvolume, but you can also see some additional subvolumes present as well, likeroot/var/lib/machinesorroot/var/lib/portables.
- This refers to the
- Create a new
rootsubvolume and set the/mountpoint to it.- If you already have a
rootsubvolume, because you decided to not delete the old one, that's not a problem, just name the new one differently.
- If you already have a
- Complete the installation process, making sensible selections for all other installer options.
- Boot the installed system.
- After logging in, check that your home directory or
/homecontains the files you created on your previous system (check their contents as well).
Expected Results
- The expected partition layout should be created on the target device(s).
- The install process should complete successfully and the installed system should boot as expected.
- The partitions and subvolumes which were assigned some mountpoints in the installer should be mounted. Any partitions or subvolumes which weren't assigned any mountpoints shouldn't be mounted.
- Your personal files on your
/homepartition must be intact.