From Fedora Project Wiki

(use template for result steps)
(use template for description)
 
Line 2: Line 2:


{{QA/Test_Case
{{QA/Test_Case
|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.
|description={{Testcase usb description|command=the livecd-iso-to-disk command}}
{{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=
{{Testcase usb setup}}
{{Testcase usb setup}}

Latest revision as of 19:08, 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, and if a DVD image was used, uses the package repository on the USB stick (not a network repository).
  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.