From 40e893501729ae7b4bc4ada1b01a11b02189a904 Mon Sep 17 00:00:00 2001 From: Zach Ploskey Date: Sep 15 2017 19:55:38 +0000 Subject: Cleanup, clarify mediawriter/liveusb-creator change Signed-off-by: Zach Ploskey --- diff --git a/en-US/install/Preparing_for_Installation.adoc b/en-US/install/Preparing_for_Installation.adoc index db0d50c..accf811 100644 --- a/en-US/install/Preparing_for_Installation.adoc +++ b/en-US/install/Preparing_for_Installation.adoc @@ -18,9 +18,7 @@ Manual Reinstallation:: You can upgrade to the latest version of Fedora manuall [WARNING] ==== - Always back up your data before performing an upgrade or reinstalling your system, no matter which method you choose. - ==== [[sect-preparing-obtaining-images]] @@ -51,7 +49,6 @@ By calculating the image's `checksum` on your own computer and comparing it to t + [subs="macros"] ---- - > cd $HOME\Downloads\ > ls @@ -62,26 +59,21 @@ Mode LastWriteTime Length Name -a--- 11/25/2014 12:39 PM 272 Fedora-Server-21-x86_64-CHECKSUM -a--- 11/25/2014 12:39 PM 2047868928 Fedora-Server-DVD-x86_64-21.iso - ---- . Load the resources required to calculate the checksum. + ---- - > $image = "Fedora-Server-DVD-x86_64-21.iso" > $checksum_file = "Fedora-Server-21-x86_64-CHECKSUM" > $sha256 = New-Object -TypeName System.Security.Cryptography.sha256CryptoServiceProvider > $expected_checksum = ((Get-Content $checksum_file | Select-String -Pattern $image) -split " ")[0].ToLower() - ---- . Calculate the downloaded image's checksum. This will take a while! + ---- - > $download_checksum = [System.BitConverter]::ToString($sha256.ComputeHash([System.IO.File]::ReadAllBytes("$PWD\$image"))).ToLower() -replace '-', '' - ---- . Compare the calculated checksum to the expected checksum. @@ -147,11 +139,10 @@ These methods circumvent the boot-loader configuration built into Fedora images, Utilities that use a direct write method, and do not modify the Fedora image, will produce the most consistently successful results. -==== - -.Be sure you choose the right device! [WARNING] ==== +Be sure you choose the right device! +==== Most media creation methods in this section are destructive. Ensure you do not need any data on the USB stick, and double check you have chosen the correct device before continuing. @@ -169,7 +160,7 @@ Most media creation methods in this section are destructive. Ensure you do not n [[figu-fedora_media_writer_choose_flavor_windows]] .Fedora Media Writer Main Screen: Choose your Edition of Fedora + -image::fedora_media_writer/main_screen.png[Image of Fedora Image Writer Main Screen] +image::fedora_media_writer/main_screen.png[Image of Fedora Media Writer Main Screen] . If you choose one of the beginning default Fedora editions, such as Fedora workstation or server. [application]*Fedora Media Writer* will give you information and details about it before you proceed with the download and USB creation. For Fedora Workstation, you can choose a different architecture, such as 32bit if you select "other architectures". Otherwise select "Create Live USB" to proceed. @@ -177,14 +168,14 @@ before you proceed with the download and USB creation. For Fedora Workstation, y [[figu-fedora_media_writer_distro_information_windows]] .Fedora Media Writer Distro Information + -image::fedora_media_writer/distro_information.png[Image of Fedora Image Writer Distro Information Screen] +image::fedora_media_writer/distro_information.png[Image of Fedora Media Writer Distro Information Screen] . Fedora Media Writer will automatically download the ISO for you, but if you all-ready have it in your Downloads directory it will be immediately available to use. + [[figu-fedora_media_writer_Automatic_download_windows]] .Fedora Media Writer Automatic Download + -image::fedora_media_writer/automatic_download.png[Image of Fedora Image Writer Automatic Download] +image::fedora_media_writer/automatic_download.png[Image of Fedora Media Writer Automatic Download] . After the download completes, or when [application]*Fedora Media Writer* is ready. Plug in a USB drive you wish to use as a bootable media. @@ -193,31 +184,37 @@ image::fedora_media_writer/automatic_download.png[Image of Fedora Image Writer A [[figu-fedora_media_writer_write_to_device_windows]] .Fedora Media Writer Write to USB Device + -image::fedora_media_writer/write_to_device.png[Image of Fedora Image Writer write to device red button] +image::fedora_media_writer/write_to_device.png[Image of Fedora Media Writer write to device red button] -.Creating USB Media with Fedora Media Writer on Fedora 24 and later -. On Fedora 24 or later, you can download Fedora Image Writer with the command: +.Creating USB Media with Fedora Media Writer. +. On Fedora 25 or later, you can download Fedora Media Writer with the command: + [subs="quotes, macros, attributes"] ---- -$ [command]#sudo dnf install liveusb-creator# +$ [command]#sudo dnf install mediawriter# ---- - -. You can call [application]*Fedora Media Writer* by issuing the command: ++ +[TIP] +==== +In Fedora 24 and earlier this package and binary are named `liveusb-creator`, +so replace `mediawriter` with `liveusb-creator`. +==== ++ +. You can call [application]*Fedora Media Writer* by issuing the command: + [subs="quotes, macros, attributes"] ---- -$ [command]#sudo liveusb-creator# +$ [command]#sudo mediawriter# ---- + -or in [application]*gnome 3* by selecting *activities,* then selecting *system tools*, and then selecting [application]*Fedora LiveUSB Creator* - +or in [application]*Gnome 3* by selecting *activities,* then selecting *system tools*, and then selecting [application]*Fedora Media Writer*. ++ . Select the Fedora Edition you wish to make a bootable USB drive for. + [[figu-fedora_media_writer_choose_flavor_linux]] .Fedora Media Writer Main Screen: Choose your Edition of Fedora + -image::fedora_media_writer/main_screen.png[Image of Fedora Image Writer Main Screen] +image::fedora_media_writer/main_screen.png[Image of Fedora Media Writer Main Screen] . If you choose one of the beginning default Fedora editions, such as Fedora workstation or server. [application]*Fedora Media Writer* will give you information and details about it before you proceed with the download and USB creation. For Fedora Workstation, you can choose a different architecture, such as 32bit if you select "other architectures". Otherwise select "Create Live USB" to proceed. @@ -225,14 +222,14 @@ before you proceed with the download and USB creation. For Fedora Workstation, y [[figu-fedora_media_writer_distro_information_fedora]] .Fedora Media Writer Distro Information + -image::fedora_media_writer/distro_information.png[Image of Fedora Image Writer Distro Information Screen] +image::fedora_media_writer/distro_information.png[Image of Fedora Media Writer Distro Information Screen] . Fedora Media Writer will automatically download the ISO for you, but if you all-ready have it in your Downloads directory it will be immediately available to use. + [[figu-fedora_media_writer_Automatic_download_fedora]] .Fedora Media Writer Automatic Download + -image::fedora_media_writer/automatic_download.png[Image of Fedora Image Writer Automatic Download] +image::fedora_media_writer/automatic_download.png[Image of Fedora Media Writer Automatic Download] . After the download completes, or when [application]*Fedora Media Writer* is ready. Plug in a USB drive you wish to use as a bootable media. @@ -241,7 +238,7 @@ image::fedora_media_writer/automatic_download.png[Image of Fedora Image Writer A [[figu-fedora_media_writer_write_to_device_linux]] .Fedora Media Writer Write to USB Device + -image::fedora_media_writer/write_to_device.png[Image of Fedora Image Writer write to device red button] +image::fedora_media_writer/write_to_device.png[Image of Fedora Media Writer write to device red button] .Creating USB Media on Macintosh . Download the latest Macintosh Disk Image (the package will have a .dmg extension) from Marin Briza's github page: link:++https://github.com/MartinBriza/MediaWriter/releases++[https://github.com/MartinBriza/MediaWriter/releases]. @@ -257,7 +254,7 @@ image::fedora_media_writer/write_to_device.png[Image of Fedora Image Writer writ [[figu-fedora_media_writer_choose_flavor_mac]] .Fedora Media Writer Main Screen: Choose your Edition of Fedora + -image::fedora_media_writer/main_screen.png[Image of Fedora Image Writer Main Screen] +image::fedora_media_writer/main_screen.png[Image of Fedora Media Writer Main Screen] . If you choose one of the beginning default Fedora editions, such as Fedora workstation or server. [application]*Fedora Media Writer* will give you information and details about it before you proceed with the download and USB creation. For Fedora Workstation, you can choose a different architecture, such as 32bit if you select "other architectures". Otherwise select "Create Live USB" to proceed. @@ -265,14 +262,14 @@ before you proceed with the download and USB creation. For Fedora Workstation, y [[figu-fedora_media_writer_distro_information_mac]] .Fedora Media Writer Distro Information + -image::fedora_media_writer/distro_information.png[Image of Fedora Image Writer Distro Information Screen] +image::fedora_media_writer/distro_information.png[Image of Fedora Media Writer Distro Information Screen] . Fedora Media Writer will automatically download the ISO for you, but if you all-ready have it in your Downloads directory it will be immediately available to use. + [[figu-fedora_media_writer_Automatic_download_mac]] .Fedora Media Writer Automatic Download + -image::fedora_media_writer/automatic_download.png[Image of Fedora Image Writer Automatic Download] +image::fedora_media_writer/automatic_download.png[Image of Fedora Media Writer Automatic Download] . After the download completes, or when [application]*Fedora Media Writer* is ready. Plug in a USB drive you wish to use as a bootable media. @@ -281,7 +278,7 @@ image::fedora_media_writer/automatic_download.png[Image of Fedora Image Writer A [[figu-fedora_media_writer_write_to_device_mac]] .Fedora Media Writer Write to USB Device + -image::fedora_media_writer/write_to_device.png[Image of Fedora Image Writer write to device red button] +image::fedora_media_writer/write_to_device.png[Image of Fedora Media Writer write to device red button] .Creating USB media with [application]*GNOME Disks* . On a system with [application]*GNOME*, or with the [package]*gnome-disk-utility* package installed, open `Disks` using the system menu. @@ -299,7 +296,6 @@ image::fedora_media_writer/write_to_device.png[Image of Fedora Image Writer writ + [subs="quotes, macros, attributes"] ---- - $ [command]#dmesg|tail# [288954.686557] usb 2-1.8: New USB device strings: Mfr=0, Product=1, SerialNumber=2 [288954.686559] usb 2-1.8: Product: USB Storage @@ -310,8 +306,7 @@ $ [command]#dmesg|tail# [288954.716682] usbcore: registered new interface driver uas [288955.717140] scsi 6:0:0:0: Direct-Access Generic STORAGE DEVICE 9228 PQ: 0 ANSI: 0 [288955.717745] sd 6:0:0:0: Attached scsi generic sg4 type 0 -[288961.876382] sd 6:0:0:0: `[sdd]` Attached SCSI removable disk - +[288961.876382] sd 6:0:0:0: *sdd* Attached SCSI removable disk ---- . Use the [command]#dd# utility to write the image. *Make sure you have the right drive!*