[id='proc_creating-and-using-live-cd']

  = Creating and using live CD

  [[getting-started]]

  == Getting started

  Replace `_filename.iso_` with the name of your created Live CD image and `_qemu-system-x86_64_` with an appropriate qemu binary for the target system, e.g. `qemu-system-i386`.

  [id='live-image-media-verification']

  == Live image media verification

  [id='using-fedora-media-writer']

  == Using Fedora Media Writer

  [IMPORTANT]

  IMPORTANT: This method will destroy all data on the USB stick _if the `--format` parameter is passed_.

  . You may use a _non-destructive_ method to create the stick, meaning existing files on the stick will not be destroyed. This is less reliable than the _destructive_ write methods, and should be used only if you have no stick you can afford to wipe.

  . On live images, you can include a feature called a _persistent overlay_, which allows changes made to persist across reboots. You can perform updates just like a regular installation to your hard disk, except that kernel updates require manual intervention and overlay space may be insufficient. Without a _persistent overlay_, the stick will return to a fresh state each time it is booted.

  This method will destroy all data on the USB stick. If you need a non-destructive write method, to preserve existing data on your USB stick, and/or support for `data persistence`, you can use the `livecd-iso-to-disk` utility on Fedora.

  ====

  . Identify the name of the USB drive partition. If using this method on Windows, with the port linked above, the `dd --list` command should provide you with the correct name.

  . *Unmount all mounted partition from that device*. This is very important, otherwise the written image might get corrupted. You can umount all mounted partitions from the device with `umount /dev/sdX*`, where `_X_` is the appropriate letter, e.g. `umount /dev/sdc*`.

  [id='unetbootin']

  [WARNING]

  ====

  // * Title: = Doing procedure A

  // The ID is used as an anchor for linking to the module. Avoid changing it after the module has been published to ensure existing links are not broken.

  // The `context` attribute enables module reuse. Every module's ID includes {context}, which ensures that the module has a unique ID even if it is reused multiple times in a guide.

  // Start the title of a procedure module with a verb, such as Creating or Create. See also _Wording of headings_ in _The IBM Style Guide_.

  include::{partialsdir}/attributes.adoc[]

  ._Prerequisites_

  * Raspberry Pi Model B, version 2 or 3.

  * A microSD Card (16 GB or larger).

  * SD card reader.

  * A Fedora ARM image from: link:https://arm.fedoraproject.org/[].

  * File-decompression software (such as link:https://theunarchiver.com/[The Unarchiver desktop application] or link:https://theunarchiver.com/command-line[The Unarchiver command-line tools]).

  $ unar Fedora-Server-armhfp-{MAJOROSVER}-1.1-sda.raw.xz

  ----

  +

  [NOTE]

  ====

  ** For Fedora users, see: <<installing-fedora-on-a-raspberry-pi-using-the-fedora-arm-installer_{context}>>.

  ** For users of other Linux distributions, see: <<installing-fedora-on-a-raspberry-pi-for-linux-users_{context}>>.

  ** For Microsoft Windows users, see: <<installing-fedora-on-a-raspberry-pi-for-microsoft-windows-users_{context}>>.

  * If you try to use Fedora on a Raspberry Pi 1, Raspberry Pi Zero, or a Raspberry Pi model A, you will receive the rainbow display. This occurs because your Raspberry Pi is not supported (ARMv6 SoCs architectures are not supported).

  :context: creating-an-using-a-live-installation-image

  = Creating and using a live installation image

  include::{partialsdir}/proc_downloading-fedora.adoc[leveloffset=+1]

  include::{partialsdir}/proc_creating-and-using-live-usb.adoc[leveloffset=+1]

  [[chap-dnf]]

  = Using the DNF software package manager

  DNF is a software package manager that installs, updates, and removes packages on Fedora and is the successor to YUM (Yellow-Dog Updater Modified).

  DNF makes it easy to maintain packages by automatically checking for dependencies and determines the actions required to install packages.

  This method eliminates the need to manually install or update the package, and its dependencies, using the `rpm` command.

  * `reinstall` - reinstalls the currently installed package.

  For more DNF commands refer to the man pages by typing `man dnf` at the command-line, or link:http://dnf.readthedocs.io/en/latest/command_ref.html[DNF Read The Docs]

  . http://dnf.readthedocs.org/en/latest/command_ref.html[DNF Command Reference]

  . https://github.com/rpm-software-management/dnf/wiki[DNF wiki]

  :context: rpi

  // The `context` attribute enables module reuse. Every module's ID includes {context}, which ensures that the module has a unique ID even if it is reused multiple times in a guide.

  include::{partialsdir}/attributes.adoc[]

  The link:https://www.raspberrypi.org[Raspberry Pi] is a credit card-sized ARM based single board computer (SBC).

  The Raspberry Pi Model B versions 2 and 3 are supported for Fedora 25 or newer, without any requirement of third party kernels or scripts to adjust offical images.

  * A USB keyboard and USB mouse.

  * SD card reader.

  * A microSD Card (16 GB or larger).

  * A Fedora ARM image from: link:https://arm.fedoraproject.org/[].

  * For Fedora users, see: <<installing-fedora-on-a-raspberry-pi-using-the-fedora-arm-installer_{context}>>.

  * For users of other Linux distributions, see: <<installing-fedora-on-a-raspberry-pi-for-linux-users_{context}>>.

  * For Microsoft Windows users, see: <<installing-fedora-on-a-raspberry-pi-for-microsoft-windows-users_{context}>>.

  // The following include statements pull in the module files that comprise the assembly. Include any combination of concept, procedure, or reference modules required to cover the user story. You can also include other assemblies.

  include::{partialsdir}/proc_installing-fedora-on-a-raspberry-pi-for-microsoft-windows-users.adoc[leveloffset=+1]

  include::{partialsdir}/proc_booting-fedora-on-a-raspberry-pi-for-the-first-time.adoc[leveloffset=+1]