From Fedora Project Wiki

(link to "poor UI bugreport")
(few clarifications)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Beta|disk-layouts}}
+
{{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=
 
|setup=
# Install Fedora 33 with default options. Pick an Edition or Spin which uses ''btrfs'' layout by default. Use ''Automatic storage configuration'' during disk partitioning.
+
# Install Fedora {{CurrentFedoraVersion}} or {{FedoraVersionNumber|next}} from any Edition or Spin which uses ''Btrfs'' filesystem by default. Use ''Automatic storage configuration'' during disk partitioning.
 
# On the installed system, create some distinct files and directories in your home directory or directly in `/home`
 
# On the installed system, create some distinct files and directories in your home directory or directly in `/home`
 
|actions=
 
|actions=
# Boot the Fedora 33 installer, make sensible choices
+
# Select a Fedora {{FedoraVersionNumber|next}} installer for any Edition or Spin which uses ''Btrfs'' filesystem by default.
 +
{{Template:partitioning_actions}}
 
# In Installation Destination, click ''Custom'' under Storage Configuration
 
# In Installation Destination, click ''Custom'' under Storage Configuration
# Under ''New mount points will use the following partitioning scheme'', select ''Btrfs'' (otherwise you'll not be able to create a new `/root` subvolume 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])).
+
# 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])).
 
# Locate the previous Fedora installation, click on it to reveal existing mount points for reuse
 
# Locate the previous Fedora installation, click on it to reveal existing mount points for reuse
 
# If present, select `/boot/efi` or `BIOS Boot` mount point, on the right hand side at the top, find ''Mount Point'' field, type in `/boot/efi`, click ''Update Settings'' button.
 
# If present, select `/boot/efi` or `BIOS Boot` mount point, on the right hand side at the top, find ''Mount Point'' field, type in `/boot/efi`, click ''Update Settings'' button.
 
# Select `/boot` mount point, on the right hand side at the top, find ''Mount Point'' field, type in `/boot`, check the ''Reformat'' box, click ''Update Settings'' button.
 
# Select `/boot` mount point, on the right hand side at the top, find ''Mount Point'' field, type in `/boot`, check the ''Reformat'' box, click ''Update Settings'' button.
 
# Select `/home` mount point, on the right hand side at the top, find ''Mount Point'' field, type in `/home`, click ''Update Settings'' button.
 
# Select `/home` mount point, on the right hand side at the top, find ''Mount Point'' field, type in `/home`, click ''Update Settings'' button.
# 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. Optional: change the name of the subvolume from `root00` to `rootkde` or `rootjam` per your preference).. Click ''Update Settings'' button.
+
# 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. Optional: change the name of the subvolume from `root00` to `rootkde` or `rootjam` per your preference).. Click ''Update Settings'' button.
#* Note: If you don't delete the previous `root` subvolume, the installer will create a new subvolume `root00` mounted at `/`. If you delete the previous `root` subvolume first, the installer will use the same `root` name for the new one. Both approaches are valid, you can use whichever approach you choose. Other than consuming space, there is no disadvantage to keeping the old `root`.
+
#* 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.
 
# Click ''Done''
 
# Click ''Done''
# Perform the installation and reboot the machine. At initial setup, it's recommended to use all the same settings as for the 1st installation.
+
# Perform the installation and reboot the machine. At the initial setup, it's recommended to use all the same settings as for the 1st installation.
 
# After logging in, check that your home directory or `/home` contains the files you created on your previous system (check their contents as well)
 
# After logging in, check that your home directory or `/home` contains the files you created on your previous system (check their contents as well)
 
|results=
 
|results=
# The installation should continue without fail
+
{{Template:partitioning_results}}
# The `/home` directory should have your previously-created files
+
# Your personal files on your `/home` partition must be intact
 
}}
 
}}
 
[[Category:Installer_Partitioning_Test_Cases]]
 
[[Category:Installer_Partitioning_Test_Cases]]
 
[[Category:btrfs]]
 
[[Category:btrfs]]

Latest revision as of 19:46, 15 February 2021

Note.png
Associated release criterion
This test case is associated with the Fedora_35_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. Install Fedora 34 or 35 from any Edition or Spin which uses Btrfs filesystem by default. Use Automatic storage configuration during disk partitioning.
  2. On the installed system, create some distinct files and directories in your home directory or directly in /home

How to test

  1. Select a Fedora 35 installer for any Edition or Spin which uses Btrfs filesystem by default.
  2. Boot the installer using any available means.
  3. Proceed to the installer's main screen, making sensible choices, and enter the Installation Destination screen.
  4. In Installation Destination, click Custom under Storage Configuration
  5. 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)).
  6. Locate the previous Fedora installation, click on it to reveal existing mount points for reuse
  7. If present, select /boot/efi or BIOS Boot mount point, on the right hand side at the top, find Mount Point field, type in /boot/efi, click Update Settings button.
  8. Select /boot mount point, on the right hand side at the top, find Mount Point field, type in /boot, check the Reformat box, click Update Settings button.
  9. Select /home mount point, on the right hand side at the top, find Mount Point field, type in /home, click Update Settings button.
  10. 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. Optional: change the name of the subvolume from root00 to rootkde or rootjam per your preference).. 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.
  11. Click Done
  12. Perform the installation and reboot the machine. At the initial setup, it's recommended to use all the same settings as for the 1st installation.
  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. Your personal files on your /home partition must be intact