From Fedora Project Wiki

Revision as of 12:57, 12 April 2017 by Lbrabec (talk | contribs)

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. Run the tool:
    • On Fedora, run sudo dnf --enablerepo=updates-testing --refresh --best install mediawriter, then launch Fedora Media Writer from the system menus
    • On Windows, visit the project download page and download the latest release, install the application using the installer and either run it after installation or find Fedora Media Writer in your application list.
    • On macOS, visit the project download page and download the dmg file, open it and run mediawriter.

How to test

  1. Select the version of Fedora you want your flash drive to have, you have two options:
    • try stable Fedora release
    • try pre-release of Fedora
    1. download releases.json
    2. edit the file, add a new entry to the list with link to desired Fedora pre-release ISO and be sure to set proper version, example:
    3. [{"link": "https://dl.fp.o/.../Fedora-Workstation-Live-x86_64-25-1.3.iso", "subvariant": "Workstation", "version": "25", "arch": "x86_64", "variant": "Workstation"},
      //lines omitted
      ]
      

      to

      [{"link": "https://put/your/link/here", "subvariant": "Workstation", "version": "26", "arch": "x86_64", "variant": "Workstation"},
       {"link": "https://dl.fp.o/.../Fedora-Workstation-netinst-x86_64-25-1.3.iso", "subvariant": "Workstation", "version": "25", "arch": "x86_64", "variant": "Workstation"},
       //lines omitted
      ]
      
    4. run the media writer from command line: $ mediawriter --releasesUrl file:///path/to/edited/releases.json
  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. If possible, try both:
    • UEFI boot
    • BIOS boot
  5. For validation testing, and optionally for other testing:
    • 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.