From 34b8a75b7d9d50052f0bd416201158aa463afe58 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Oct 16 2018 15:33:26 +0000 Subject: Issue 15 - Fix image verification instructions on Mac --- diff --git a/modules/install-guide/pages/install/Preparing_for_Installation.adoc b/modules/install-guide/pages/install/Preparing_for_Installation.adoc index 033744a..ea52f7c 100644 --- a/modules/install-guide/pages/install/Preparing_for_Installation.adoc +++ b/modules/install-guide/pages/install/Preparing_for_Installation.adoc @@ -29,7 +29,7 @@ Fedora images are `Hybrid ISOs` and can be used to create installation media wit === Fedora Media Writer [application]*Fedora Media Writer* has been significantly improved and is now the official, tested and supported way to make bootable media. [application]*Fedora Media Writer* supports Linux, Mac, and Windows. It is an easy way to make -bootable USB media to install Fedora (or other operating systems). Using [application]*Fedora Media Writer* is strongly encouraged, although other USB media creation software can work as well. +bootable USB media to install Fedora (or other operating systems). Using [application]*Fedora Media Writer* is strongly encouraged, although other USB media creation software can work as well. Some of the new additions to [application]*Fedora Media Writer* are that Fedora Workstation and Server are easily and quickly accessible from the selection on the main screen. Further choices are available if you select the button below _Custom OS_. This offers a selection of various Fedora Spins, such as XFCE or Mate. @@ -41,7 +41,7 @@ The best results are produced by utilities that use a direct write method and do [WARNING] ==== -Always think twice before writing an image to the device. The media creation methods described in this article are destructive. +Always think twice before writing an image to the device. The media creation methods described in this article are destructive. All data on the USB stick are deleted during the process, so make sure you have a back up of the data on the USB stick. Double check that you have selected correct device to write the image to! ==== @@ -49,7 +49,7 @@ All data on the USB stick are deleted during the process, so make sure you have ==== On Fedora -On Fedora 25 or later, [application]*Fedora Media Writer* is available in the default repository. You can use `dnf` to install the +On Fedora 25 or later, [application]*Fedora Media Writer* is available in the default repository. You can use `dnf` to install the package. . To install the [application]*Fedora Media Writer* using: @@ -71,7 +71,7 @@ or in [application]*Gnome 3* select *Activities,* then select *Utilities*, and t ==== On other Linux distributions -The best way to install [application]*Fedora Media Writer* on various Linux distributions is to use the pre-built _Flatpak_ package. +The best way to install [application]*Fedora Media Writer* on various Linux distributions is to use the pre-built _Flatpak_ package. The package can be obtained from the official Flatpak repository https://flathub.org/apps/details/org.fedoraproject.MediaWriter[Flathub.org]. . To setup *Flatpak* on your Linux system, follow the guidelines on the https://flatpak.org/setup/[Flatpak documentation] page. @@ -112,7 +112,7 @@ In Windows 8 and 10, the [application]*Fedora Media Writer* launcher will be pla + image::fedora_media_writer/main_screen.png[Image of Fedora Media Writer Main Screen] + -The main selection lets you choose one of the default Fedora editions, Fedora *Workstation* or *Server*. [application]*Fedora Media Writer* displays more details about the edition before you can proceed with downloading the image and the USB creation. You can choose a different architecture, if you select _Other variants_. +The main selection lets you choose one of the default Fedora editions, Fedora *Workstation* or *Server*. [application]*Fedora Media Writer* displays more details about the edition before you can proceed with downloading the image and the USB creation. You can choose a different architecture, if you select _Other variants_. . Select "Create Live USB" to proceed. + @@ -139,7 +139,7 @@ image::fedora_media_writer/write_to_device.png[Image of Fedora Media Writer writ === Other methods to create a live USB -Using the *Fedora Media Writer* is highly recommended for everybody, because it offers a reliable way to create a live USB stick for Fedora installation. +Using the *Fedora Media Writer* is highly recommended for everybody, because it offers a reliable way to create a live USB stick for Fedora installation. However, some experienced users may prefer to go through the creation process manually. If you decide to do so, you have to download the installation images and use an application to write them onto the USB stick. @@ -241,7 +241,7 @@ $ sha256sum -c *CHECKSUM + [subs="macros, attributes"] ---- -$ shasum -a 256 -c *CHECKSUM +$ grep '^SHA256' *-CHECKSUM | awk -F '[()=]' '{ print $4 " " $2 }' | shasum -a 256 -c ---- === Writing the images to USB media @@ -285,8 +285,8 @@ $ [command]#dmesg|tail# [WARNING] ==== Pay extreme attention to the source (`if=`) and target (`of=`) device. The `dd` command destroys all data on the -target device. If you made a mistake, you could lose important data. -==== +target device. If you made a mistake, you could lose important data. +==== === Creating a Boot CD or DVD In addition to creating a bootable USB flash drive, you can also use the provided ISO images to create bootable optical media (a CD or DVD). This approach may be necessary when installing {PRODUCT} on an older system which can not boot from USB.