From Fedora Project Wiki

m (wording)
(use template for description)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Alpha|initialization_requirements}}
{{QA/Test_Case
{{QA/Test_Case
|description=This test verifies that {{filename|Live.iso}} image can be booted and installed from a USB stick created by a {{command|livecd-iso-to-disk}} command.
|description={{Testcase usb description|command=the livecd-iso-to-disk command}}
{{admon/warning|You might lose your data|This test case requires you to use low-level system utilities that can easily destroy all your data when used incorrectly. Only follow this if you are a highly-experienced user or you don't mind losing your system and your data.}}
|setup=
|setup=
# You need to have a USB stick that is larger than the {{filename|Live.iso}} image.
{{Testcase usb setup}}
# On an existing Fedora system, install {{package|livecd-tools}}.
|actions=
|actions=
# Convert the {{filename|Live.iso}} 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 that disk.'''
#* 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#Using the livecd-iso-to-disk tool]].
#* 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.
{{Testcase usb actions}}
# Start the installer.
# Proceed with the installation.
|results=
|results=
# The ISO image is converted to the USB stick without error.
{{Testcase usb results|litd=1}}
# The Live image boots without error.
# The installer starts without error.
# The installation finishes successfully.
# The new system initiates boot properly.
}}
}}


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

Latest revision as of 19:08, 30 September 2016

Note.png
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.

Warning.png
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 Package-x-generic-16.pnglivecd-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-40-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.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_USB_litd&oldid=475729"