From Fedora Project Wiki

m (Adamwill moved page QA:Testcase USB stick Live litd to QA:Testcase USB litd: Let's consolidate and sanify the USB test cases.)
(tweak wording slightly to be generic)
Line 2: Line 2:


{{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 a {{command|livecd-iso-to-disk}} command.
|description=This test verifies that a Fedora ISO image can be written to a USB stick with the livecd-iso-to-disk command, and successfully boots and installs.
{{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.}}
{{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.}}
|setup=
|setup=
# Download the live image you wish to test.
# Download the Fedora image you wish to test.
# 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).
# 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).
# On an existing Fedora system, install {{package|livecd-tools}}.
# On an existing Fedora system, install {{package|livecd-tools}}.
|actions=
|actions=
# Write the live image to the USB stick using {{command|livecd-iso-to-disk}}.
# Write the image to the USB stick using {{command|livecd-iso-to-disk}}.
#* Example command is: {{#tag:pre|# livecd-iso-to-disk --format --reset-mbr --efi Fedora-{{FedoraVersionNumber|next}}-x86_64-Live-Desktop.iso /dev/sdX}} where you replace ''sdX'' by your USB stick device identifier. '''This will destroy all data on thatstick.'''
#* Example command is: {{command|1=livecd-iso-to-disk --format --reset-mbr --efi Fedora-Workstation-Live-x86_64-{{FedoraVersionNumber|next}}-1.1.iso /dev/sdX}} where you replace ''sdX'' by your USB stick device identifier. '''This will destroy all data on that stick.'''
#* A longer guide how to use this command is available at [[How to create and use Live USB#Command line method: Using the livecd-iso-to-disk tool (Fedora only, non-graphical, both non-destructive and destructive methods available)]]. You can also run the command with {{command|--help}} option.
#* A longer guide how to use this command is available at [[How to create and use Live USB#litd]]. You can also run the command with {{command|--help}} option.
# Boot the system from the USB stick.
# Boot the system from the USB stick.
# Start the installer.
# If testing a live image, start the installer.
# Proceed with the installation.
# Proceed with the installation.
|results=
|results=
# The live image is written to the USB stick without error.
# The image is written to the USB stick without error.
# The stick boots without error.
# The stick boots 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.  
#* 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.  
# The installer starts without error.
# The installer starts without error.
# The installation finishes successfully.
# The installation finishes successfully.
# 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.
# 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. 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.
}}
}}


[[Category:Installer Boot Methods]]
[[Category:Installer Boot Methods]]
[[Category:USB_test_cases]]
[[Category:USB_test_cases]]

Revision as of 18:40, 30 September 2016

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 the livecd-iso-to-disk command, 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. Download the Fedora image you wish to test.
  2. 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).
  3. On an existing Fedora system, install livecd-tools.

How to test

  1. Write the image to the USB stick using livecd-iso-to-disk.
    • Example command is: livecd-iso-to-disk --format --reset-mbr --efi Fedora-Workstation-Live-x86_64-42-1.1.iso /dev/sdX where you replace sdX by your USB stick device identifier. This will destroy all data on that stick.
    • A longer guide how to use this command is available at How to create and use Live USB#litd. You can also run the command with --help option.
  2. Boot the system from the USB stick.
  3. If testing a live image, start the installer.
  4. Proceed with the installation.

Expected Results

  1. The image is written to the USB stick without error.
  2. The stick boots 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.
  3. The installer starts without error.
  4. The installation finishes successfully.
  5. 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. 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.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_USB_litd&oldid=475713"