From Fedora Project Wiki

(add example command, add big fat warning about dangerous test case)
(use templates for description and results)
 
(13 intermediate revisions by 3 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|dd}} command.
|description={{Testcase usb description|command=the {{command|dd}} 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}}
# Ensure you have an existing Linux (or other Unix) system with the {{command|dd}} command available.
|actions=
|actions=
# Convert the {{filename|Live.iso}} image to the USB stick using {{command|dd}}.
# Write the image image to the USB stick using {{command|dd}}.
#* Example command is: {{#tag:pre|# dd if=Fedora-{{FedoraVersionNumber|next}}-x86_64-Live-Desktop.iso of=/dev/sdX bs=16M}} where you replace ''sdX'' by your USB stick device identifier. '''This will destroy all data on that disk.'''
#* Example command is: {{command|1=dd if=Fedora-Workstation-Live-x86_64-{{FedoraVersionNumber|next}}-1.1.iso of=/dev/sdX bs=16M status=progress oflag=direct}} where you replace ''sdX'' by your USB stick device identifier. '''This will destroy all data on that disk.'''
#* A longer guide how to use this command is available at [[How to create and use Live USB#Using dd for a direct copy]].
#* A longer guide how to use this command is available at [[How to create and use Live USB#dd]].
# 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=0}}
# 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]]
[[Category:USB_test_cases]]

Latest revision as of 19:09, 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 dd 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. Ensure you have an existing Linux (or other Unix) system with the dd command available.

How to test

  1. Write the image image to the USB stick using dd.
    • Example command is: dd if=Fedora-Workstation-Live-x86_64-40-1.1.iso of=/dev/sdX bs=16M status=progress oflag=direct where you replace sdX by your USB stick device identifier. This will destroy all data on that disk.
    • A longer guide how to use this command is available at How to create and use Live USB#dd.
  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.
  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_dd&oldid=475730"