[install-guide] Various fixes and enhancements in 3.2. Preparing a USB flash drive as an installation source

pbokoc pbokoc at fedoraproject.org
Tue Jul 9 18:46:56 UTC 2013


commit c29f055279422984f46b76b6487af6053c95a953
Author: Petr Bokoc <pbokoc at redhat.com>
Date:   Tue Jul 9 20:46:29 2013 +0200

    Various fixes and enhancements in 3.2. Preparing a USB flash drive as an installation source

 en-US/Making_USB_media.xml          |   68 ++++++++++++++---------------------
 en-US/Procedure-dd_Image_to_USB.xml |   14 ++-----
 2 files changed, 31 insertions(+), 51 deletions(-)
---
diff --git a/en-US/Making_USB_media.xml b/en-US/Making_USB_media.xml
index 4c91ad5..9f3ab3b 100644
--- a/en-US/Making_USB_media.xml
+++ b/en-US/Making_USB_media.xml
@@ -26,13 +26,13 @@
 	</para> -->
 	<section id="Making_USB_Media-Windows">
 		<title>Making Fedora USB Media on a Windows Operating System</title>
-		<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+		<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 		<para>
 			The most straightforward way to place a Fedora image on USB media using a Windows operating system is to transfer the Fedora live image to the USB device with the <application>LiveUSB Creator</application> tool.
 		</para>
 		<para>
 			Note that the <application>dd</application> tool discussed in <xref linkend="Making_USB_Media-UNIX_Linux"/> is also available for Windows. Follow the instructions in that section to use an implementation of <application>dd</application> for Windows operating systems. The instructions in this section assume that you will use <application>LiveUSB Creator</application>.
-		      </para>
+		</para>
 		<procedure>
 			<step>
 				<para>
@@ -78,14 +78,14 @@
 			</para>
 			<section id="Making_USB_Media-UNIX_Linux-RHEL_Fedora-graphical">
 				<title>Making Fedora USB Media with a graphical tool</title>
-				<xi:include href="Important-Enable_EPEL.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-				<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+				<xi:include href="Important-Enable_EPEL.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+				<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 				<procedure>
 					<step>
 						<para>
 							Install the <package>liveusb-creator</package> on your system with your graphical package manager, or the following command:
 						</para>
-<screen><![CDATA[su -c 'yum -y install liveusb-creator']]></screen>
+<screen><command>su -c 'yum -y install liveusb-creator'</command></screen>
 					</step>
 					<step>
 						<para>
@@ -123,35 +123,34 @@
 			</section>
 			<section id="Making_USB_Media-UNIX_Linux-RHEL_Fedora-livecd-tools">
 				<title>Making Fedora USB Media with <application>livecd-tools</application></title>
-				<xi:include href="Important-Enable_EPEL.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-				<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+				<xi:include href="Important-Enable_EPEL.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+				<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 				<procedure>
 					<step>
 						<para>
 							Install the <package>livecd-tools</package> package on your system with your graphical package manager, or the following command:
 						</para>
-<screen><![CDATA[su -c 'yum -y install livecd-tools']]></screen>
+<screen><command>su -c 'yum -y install livecd-tools'</command></screen>
 					</step>
 					<step>
 						<para>
-							Plug in your USB media.
+							Plug in your USB flash drive.
 						</para>
 					</step>
 					<step>
 						<para>
-							Find the device name for your USB media.  If the media has a volume name, use it to look up the device name in <filename class="directory">/dev/disk/by-label</filename>, or use the <command>findfs</command>:
+							Find the flash drive's device name.  If the media has a volume name, use it to look up the device name in <filename class="directory">/dev/disk/by-label</filename>, or use the <command>findfs</command> command:
 						</para>
-<screen><![CDATA[su -c 'findfs LABEL="]]><replaceable>MyLabel</replaceable><![CDATA["']]></screen>
+<screen><command>findfs LABEL=<replaceable>MyLabel</replaceable></command></screen>
 						<para>
-							If the media does not have a volume name, or you do not know it, consult the <filename>/var/log/messages</filename> log for details:
+							If the media does not have a volume name or you do not know it, you can also use the <command>dmesg</command> command shortly after connecting the media to your computer. After running the command, the device name (such as <systemitem>sdb</systemitem> or <systemitem>sdc</systemitem>) should appear in several lines towards the end of the output.
 						</para>
-<screen><![CDATA[su -c 'less /var/log/messages']]></screen>
 					</step>
 					<step>
 						<para>
 							Use the <command>livecd-iso-to-disk</command> command to write the ISO image to the media:
 						</para>
-<screen><![CDATA[su -c 'livecd-iso-to-disk ]]><replaceable>the_image.iso</replaceable><![CDATA[ /dev/]]><replaceable>sdX1</replaceable><![CDATA[']]></screen>
+<screen><command>su -c 'livecd-iso-to-disk <replaceable>the_image.iso</replaceable>/dev/<replaceable>sdX1</replaceable>'</command></screen>
 						<para>
 							Replace <replaceable>sdX1</replaceable> with the device name for the partition on the USB media.  Most flash drives and external hard disks use only one partition.  If you have changed this behavior or have oddly partitioned media, you may need to consult other sources of help.
 						</para>
@@ -160,9 +159,9 @@
 			</section>
 			<section id="Making_USB_Media-UNIX_Linux-RHEL_Fedora-dd">
 				<title>Making Fedora USB Media with <application>dd</application></title>
-				<xi:include href="DU-Preparing_a_driver_update_disk_ppc_x86-warning-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-				<xi:include href="DU-livecdtools_recommended-note-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-				<xi:include href="Procedure-dd_Image_to_USB.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+				<xi:include href="DU-Preparing_a_driver_update_disk_ppc_x86-warning-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+				<xi:include href="DU-livecdtools_recommended-note-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+				<xi:include href="Procedure-dd_Image_to_USB.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 			      </section>
 		</section>
 		<section id="Making_USB_Media-UNIX_Linux-other">
@@ -171,8 +170,8 @@
 				To create Fedora USB media from a DVD or live image on a computer that uses a Linux distribution other than Fedora and those derived from Fedora, use one of the command-line procedures detailed in this section. 
 			</para>
 			<section id="Making_USB_Media-UNIX_Linux-other_livecd-tools">
-			<title>Making Fedora USB Media with <application>livecd-tools</application></title>
-				<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+				<title>Making Fedora USB Media with <application>livecd-tools</application></title>
+				<xi:include href="Note_Nondestructive_Method.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 				<para>
 					This method works only on Linux operating systems. 
 				</para>
@@ -184,18 +183,17 @@
 					</step>
 					<step>
 						<para>
-							Plug in your USB media.
+							Plug in your USB flash drive.
 						</para>
 					</step>
 					<step>
 						<para>
-							Find the device name for your USB media.  If the media has a volume name, look up the name in <filename class="directory">/dev/disk/by-label</filename>, or use the <command>findfs</command>:
+							Find the flash drive's device name.  If the media has a volume name, use it to look up the device name in <filename class="directory">/dev/disk/by-label</filename>, or use the <command>findfs</command> command:
 						</para>
-<screen><![CDATA[su -c 'findfs LABEL="]]><replaceable>MyLabel</replaceable><![CDATA["']]></screen>
+<screen><command>findfs LABEL=<replaceable>MyLabel</replaceable></command></screen>
 						<para>
-							If the media does not have a volume name, or you do not know it, consult the <filename>/var/log/messages</filename> log for details:
+							If the media does not have a volume name or you do not know it, you can also use the <command>dmesg</command> command shortly after connecting the media to your computer. After running the command, the device name (such as <systemitem>sdb</systemitem> or <systemitem>sdc</systemitem>) should appear in several lines towards the end of the output.
 						</para>
-<screen><![CDATA[su -c 'less /var/log/messages']]></screen>
 					</step>
 					<step>
 						<para>
@@ -275,25 +273,13 @@
 			</section>
 			<section id="Making_USB_Media-UNIX_Linux-other-dd">
 				<title>Making Fedora USB Media with <application>dd</application></title>
-				<xi:include href="DU-Preparing_a_driver_update_disk_ppc_x86-warning-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-				<xi:include href="DU-livecdtools_recommended-note-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+				<xi:include href="DU-Preparing_a_driver_update_disk_ppc_x86-warning-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+				<xi:include href="DU-livecdtools_recommended-note-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 				<para>
 					Use this method for the distribution image, the minimal boot media image, or on systems with a UNIX operating system (including Mac&nbsp;OX&nbsp;X).
 				</para>
-
-				<xi:include href="Procedure-dd_Image_to_USB.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-				
-			      </section>
-				</section>
+				<xi:include href="Procedure-dd_Image_to_USB.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+			</section>
+		</section>
 	</section>  
-	
-	
-	
-	
-	
-	
-	
-	
-
-
 </section>
diff --git a/en-US/Procedure-dd_Image_to_USB.xml b/en-US/Procedure-dd_Image_to_USB.xml
index 7a13d66..b4b0d54 100644
--- a/en-US/Procedure-dd_Image_to_USB.xml
+++ b/en-US/Procedure-dd_Image_to_USB.xml
@@ -10,28 +10,22 @@
 	</step>
 	<step>
 		<para>
-			Find the flash drive's device name.  If the media has a volume name, use it to look up the device name in <filename class="directory">/dev/disk/by-label</filename>, or use the <command>findfs</command>:
+			Find the flash drive's device name.  If the media has a volume name, use it to look up the device name in <filename class="directory">/dev/disk/by-label</filename>, or use the <command>findfs</command> command:
 		</para>
-<screen>findfs LABEL=<replaceable>MyLabel</replaceable></screen>
+<screen><command>findfs LABEL=<replaceable>MyLabel</replaceable></command></screen>
 		<para>
 			If the media does not have a volume name or you do not know it, you can also use the <command>dmesg</command> command shortly after connecting the media to your computer. After running the command, the device name (such as <systemitem>sdb</systemitem> or <systemitem>sdc</systemitem>) should appear in several lines towards the end of the output.
 		</para>
 	</step>
 	<step>
 		<para>
-			Become root:
-		</para>		
-<screen><command>su -</command></screen>
-	</step>
-	<step>
-		<para>
 			Use the <command>dd</command> command to transfer the boot ISO image to the USB device:
 		</para>
-<screen><command># dd if=<replaceable>path/image_name</replaceable>.iso of=/dev/<replaceable>device</replaceable></command></screen>
+<screen><command>su -c 'dd if=<replaceable>path/image_name</replaceable>.iso of=/dev/<replaceable>device</replaceable>'</command></screen>
 		<para>
 			where <replaceable>path/image_name</replaceable>.iso is the boot ISO image file that you downloaded and <filename><replaceable>device</replaceable></filename> is the device name for the USB flash drive. Ensure you specify the device name (such as <systemitem>sdc</systemitem>), not the partition name (such as <systemitem>sdc1</systemitem>). For example:
 		</para>
-<screen><command># dd if=~/Download/Fedora-&PRODVER;-x86_64-DVD.iso of=/dev/sdc</command></screen>
+<screen><command>su -c 'dd if=~/Download/Fedora-&PRODVER;-x86_64-DVD.iso of=/dev/sdc'</command></screen>
 	</step>
 </procedure>
 


More information about the docs-commits mailing list