From Fedora Project Wiki

No edit summary
m (minor rewording)
 
(27 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Alpha|initialization_requirements}}
{{Template:Associated_release_criterion|Alpha|Initialization_requirements}}


{{QA/Test_Case
{{QA/Test_Case
|description=This test verifies that a Fedora live image can be booted and installed from a USB stick created by [http://koji.fedoraproject.org/koji/buildinfo?buildID=747138 Fedora Media Writer].
|description={{Testcase usb description|command=[https://github.com/MartinBriza/MediaWriter Fedora Media Writer]}}
 
|setup=
{{admon/warning|Data loss|Any data on the USB stick used for this test is likely to be destroyed. Please do not use a stick whose contents you need to keep.}}
{{Testcase usb setup|download=0}}
==Setup and Testing on Fedora and Windows==
# Install Fedora Media Writer:
# Ensure you have a USB stick that is larger than the live image whose contents you can afford to lose (the contents of the stick will be destroyed as a part of the test).
#* On '''Fedora''', install the {{pkg|mediawriter}} RPM package: <pre>sudo dnf install mediawriter</pre>
# Run the tool:
#* To test the '''Flathub''' version, install it [https://flathub.org/apps/org.fedoraproject.MediaWriter the Flathub package] on any Linux distribution.
#* On '''Fedora''', run '''command dnf --enablerepo=updates-testing install liveusb-creator''', then launch ''Fedora LiveUSB Creator'' from the system menus
#* On '''Windows''', visit the [https://github.com/FedoraQt/MediaWriter/releases project download page], download the latest release and install it.
#* On '''Windows''', [https://mbriza.fedorapeople.org/liveusb-creator.zip download the zip file], extract it and run {{filename|liveusb-creator.exe}}
#* On '''macOS''', visit the [https://github.com/FedoraQt/MediaWriter/releases project download page] and download the dmg file.
# Launch and select the version of Fedora you want your flash drive to have
# Start Fedora Media Writer
# Let it download and see if the tool successfully wipes the content before writing the downloaded image.
 
= How to test =
# Verify Live boot with the newly created
# Boot the system from the USB stick and verify
#* UEFI boot
#* BIOS boot
# Start the installer
# Proceed with the installation
# Verify the installation is fully operational


|actions=
<ol>
<li>Decide whether you want to write a stable Fedora release image, or an unstable release image (Alpha, Beta, or even some nightly image):</li>
<ul>
  <li>If you want to write a stable image, skip to the next step.
  <li>(optional) If you want to write an unstable image, you either need to download it manually and use the ''Custom image'' menu item to select it in FMW, or you need to create a custom download list and include the link to that image in it. This is how to do it:
<ol>
<li> Download [http://getfedora.org/releases.json releases.json] </li>
<li> Edit the file, add a new entry to the list (after the initial bracket) with a link to desired Fedora pre-release ISO and be sure to set proper version, for example:
{{#tag:pre|
[{"link": "https://.../Fedora-Workstation-Live-x86_64-{{FedoraVersionNumber|next}}-1.1.iso", "subvariant": "Workstation", "version": "{{FedoraVersionNumber|next}}", "arch": "x86_64", "variant": "Workstation", "sha256": "HASH", "size": "SIZE"},
...lines omitted...
]
}}
Please note that the image filename must contain important identifiers, like Workstation/Server/Everything, Live/DVD/netinst, etc. Replace <code>HASH</code> with the hash computed by <code>sha256sum FILE.iso</code>, and <code>SIZE</code> with size printed by <code>ls -l FILE.iso</code>.
<li> Run the FMW from command line pointing to your custom download list: <code>$ mediawriter --releasesUrl file:///path/to/edited/releases.json</code></li>
<li> You should see your specified image in the list.
</ol>
</ul>
<li> Let it download an image of your preference (try a random spin/version/architecture)
<li> Write it to your flash drive
<li> Boot the system from the USB stick. For Intel images, if possible, try both:
<ul>
<li> UEFI boot
<li> BIOS boot
</ul>
<li> For validation testing, and optionally for other testing, if the image is installable:
<ul>
<li>Start the installer
<li>Proceed with the installation
</ul>
<li>Verify the installation is fully operational
<li> Start Fedora Media Writer again in the original system you started testing in
<ul>
<li> Insert the flash drive you used now
<li> Restore its partition layout inside the tool
</ul>
</ol>


|results=
|results=
# The USB will be wiped before being written with the image.
# The USB stick should be wiped before being written with the image
# The stick boots without error.
# The image should download without error
#* If you choose to perform media consistency verification before the actual boot, the check will be skipped and not performed at all, the medium will boot right away. That's expected, media verification works only for dd-style conversion.
# Writing should finish without error
# The installer starts without error.
# The stick should boot without error
# The installation finishes successfully.
#* Media consistency verification before the actual boot should end without error.
# The new system initiates boot properly. Note that problems after boot that do not seem to be related to writing the image to a USB stick are likely out of the scope of this test case, though they may count as failures of one of the other installation validation test cases.
# For validation testing, and optionally for other testing:
#* The installer should start without error
#* The installation should finish successfully
#* The installed system should boot properly. Note that problems after boot that do not seem to be related to writing the image to a USB stick are likely out of the scope of this test case, though they may count as failures of another test case. If you observe the same failure booting the image in a virtual machine or from an optical disc, it is likely not a failure of this test case.
# While restoring, you should get a notification that you can restore the drive. After restoring, the drive should contain a single FAT32 partition spanning over the whole drive.
}}
}}


[[Category:Installer Boot Methods]]
[[Category:Installer Boot Methods]]
[[Category:Package_mediawriter_test_cases]]

Latest revision as of 10:53, 22 October 2024

Associated release criterion
This test case is associated with the Basic_Release_Criteria#Initialization_requirements 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 verifies that a Fedora ISO image can be written to a USB stick with Fedora Media Writer, and successfully boots and installs.

Data loss
Any data on the USB stick used for this test is likely to be destroyed. Please do not use a stick whose contents you need to keep.

Setup

  1. Ensure you have a USB stick larger than the image file, and whose contents you can afford to lose (the contents of the stick will be destroyed as a part of the test).
  2. Install Fedora Media Writer:
  3. Start Fedora Media Writer

How to test

  1. Decide whether you want to write a stable Fedora release image, or an unstable release image (Alpha, Beta, or even some nightly image):
    • If you want to write a stable image, skip to the next step.
    • (optional) If you want to write an unstable image, you either need to download it manually and use the Custom image menu item to select it in FMW, or you need to create a custom download list and include the link to that image in it. This is how to do it:
      1. Download releases.json
      2. Edit the file, add a new entry to the list (after the initial bracket) with a link to desired Fedora pre-release ISO and be sure to set proper version, for example: 
        [{"link": "https://.../Fedora-Workstation-Live-x86_64-42-1.1.iso", "subvariant": "Workstation", "version": "42", "arch": "x86_64", "variant": "Workstation", "sha256": "HASH", "size": "SIZE"},
...lines omitted...
]

        Please note that the image filename must contain important identifiers, like Workstation/Server/Everything, Live/DVD/netinst, etc. Replace HASH with the hash computed by sha256sum FILE.iso, and SIZE with size printed by ls -l FILE.iso.

      3. Run the FMW from command line pointing to your custom download list: $ mediawriter --releasesUrl file:///path/to/edited/releases.json
      4. You should see your specified image in the list.
  2. Let it download an image of your preference (try a random spin/version/architecture)
  3. Write it to your flash drive
  4. Boot the system from the USB stick. For Intel images, if possible, try both:
    • UEFI boot
    • BIOS boot
  5. For validation testing, and optionally for other testing, if the image is installable:
    • Start the installer
    • Proceed with the installation
  6. Verify the installation is fully operational
  7. Start Fedora Media Writer again in the original system you started testing in
    • Insert the flash drive you used now
    • Restore its partition layout inside the tool

Expected Results

  1. The USB stick should be wiped before being written with the image
  2. The image should download without error
  3. Writing should finish without error
  4. The stick should boot without error
    • Media consistency verification before the actual boot should end without error.
  5. For validation testing, and optionally for other testing:
    • The installer should start without error
    • The installation should finish successfully
    • The installed system should boot properly. Note that problems after boot that do not seem to be related to writing the image to a USB stick are likely out of the scope of this test case, though they may count as failures of another test case. If you observe the same failure booting the image in a virtual machine or from an optical disc, it is likely not a failure of this test case.
  6. While restoring, you should get a notification that you can restore the drive. After restoring, the drive should contain a single FAT32 partition spanning over the whole drive.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_USB_fmw&oldid=723151"