From Fedora Project Wiki

(Created page with "{{QA/Test_Case |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...")
 
(use moar templates)
 
(25 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Beta|Custom_partitioning}}
{{QA/Test_Case
{{QA/Test_Case
|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=Install an F33 with some files & directories on the /home
|setup=
{{Template:Partitioning_single_setup}}
{{Template:Partitioning_preserve_home_setup}}
|actions=
|actions=
When reinstalling Fedora, make sensible choices and click the ''custom'' under the storage
{{Template:partitioning_actions}}
# Create /boot/efi or BIOS Boot mount point (can be reused or reformatted)
# In Installation Destination, click ''Custom'' under Storage Configuration
# Create /boot mount point (can be reused or reformatted)
# Under ''New mount points will use the following partitioning scheme'', select ''Btrfs'' (otherwise you'll not be able to create a new subvolume for `/` mountpoint later due to some [https://pagure.io/fedora-qa/issue/643#comment-677549 poor UI decisions] ([https://bugzilla.redhat.com/show_bug.cgi?id=1878620 bugzilla])).
# Create / mount point (this is required to be a new subvolume)
# Locate the previous Fedora installation, click on it to reveal existing mount points for reuse
# Locate the home subvolume you want, the current UI it's pretty easy
# If present, select `/boot/efi` or `BIOS Boot` mount point; then on the right hand side at the top, find ''Mount Point'' field, type in `/boot/efi`, click ''Update Settings'' button.
# Click on that subvolume, and on the right hand side at the top,
# Select `/boot` mount point; then on the right hand side at the top, find ''Mount Point'' field, type in `/boot`, check the ''Reformat'' box, click ''Update Settings'' button.
find Mount Point field; type in /home; click Update Settings button.
# Select `/home` mount point; then on the right hand side at the top, find ''Mount Point'' field, type in `/home`, click ''Update Settings'' button.
# Click Done
# Click {{key|+}} button to create a new `/` mount point (NOTE: this is required to be a new subvolume. Reformat will be checked, cannot be unchecked, but the underlying Btrfs is not reformatted). Click ''Update Settings'' button.
# Reboot by issuing ''init 6'' or from the UI
#* Note: If you don't delete the previous installation's `root` subvolume, the installer creates a new subvolume `root00` mounted at `/`. If you delete the previous install's `root` subvolume first, the installer will reuse `root` as the name for the new subvolume. Both approaches are valid, you can use whichever approach you choose. Other than consuming space, there is no disadvantage to keeping the old `root`. It can be deleted post-install.
# Complete the initial setup
# Click ''Done''.
{{Template:partitioning_actions_post}}
{{Template:partitioning_preserve_home_post}}
|results=
|results=
# The installation should continue without fail
{{Template:Partitioning_preserve_home_results}}
# The /home should have your files
# Open/Execute to ensure they are usable
}}
}}
[[Category:Installer_Partitioning_Test_Cases]]
[[Category:btrfs]]

Latest revision as of 00:37, 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.

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

  1. 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.
  2. 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.
  3. On the installed system, create some distinct files and directories in your home directory or directly in /home.

How to test

  1. 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.
  2. Proceed to the installer's main screen, making sensible choices, and enter the Installation Destination screen.
  3. In Installation Destination, click Custom under Storage Configuration
  4. Under New mount points will use the following partitioning scheme, select Btrfs (otherwise you'll not be able to create a new subvolume for / mountpoint later due to some poor UI decisions (bugzilla)).
  5. Locate the previous Fedora installation, click on it to reveal existing mount points for reuse
  6. If present, select /boot/efi or BIOS Boot mount point; then on the right hand side at the top, find Mount Point field, type in /boot/efi, click Update Settings button.
  7. Select /boot mount point; then on the right hand side at the top, find Mount Point field, type in /boot, check the Reformat box, click Update Settings button.
  8. Select /home mount point; then on the right hand side at the top, find Mount Point field, type in /home, click Update Settings button.
  9. Click + button to create a new / mount point (NOTE: this is required to be a new subvolume. Reformat will be checked, cannot be unchecked, but the underlying Btrfs is not reformatted). Click Update Settings button.
    • Note: If you don't delete the previous installation's root subvolume, the installer creates a new subvolume root00 mounted at /. If you delete the previous install's root subvolume first, the installer will reuse root as the name for the new subvolume. Both approaches are valid, you can use whichever approach you choose. Other than consuming space, there is no disadvantage to keeping the old root. It can be deleted post-install.
  10. Click Done.
  11. Complete the installation process, making sensible selections for all other installer options.
  12. Boot the installed system.
  13. After logging in, check that your home directory or /home contains the files you created on your previous system (check their contents as well).

Expected Results

  1. The expected partition layout should be created on the target device(s).
  2. The install process should complete successfully and the installed system should boot as expected.
  3. 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.
  4. Your personal files on your /home partition must be intact.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_partitioning_custom_btrfs_preserve_home&oldid=700805"