svn commit: r44900 - head/en_US.ISO8859-1/books/handbook/bsdinstall
Dru Lavigne
dru at FreeBSD.org
Wed May 21 15:17:22 UTC 2014
Author: dru
Date: Wed May 21 15:17:21 2014
New Revision: 44900
URL: http://svnweb.freebsd.org/changeset/doc/44900
Log:
Editorial review of Prepare the Installation Media section.
Describe the available installation files.
Sponsored by: iXsystems
Modified:
head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Wed May 21 15:13:37 2014 (r44899)
+++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Wed May 21 15:17:21 2014 (r44900)
@@ -431,116 +431,126 @@
<sect2 xml:id="bsdinstall-installation-media">
<title>Prepare the Installation Media</title>
- <para>A &os; installation is started by booting the computer
- with a &os; installation <acronym>CD</acronym>,
- <acronym>DVD</acronym>, or <acronym>USB</acronym> memory
- stick. The installer is not a program that can be run from
- within another operating system.</para>
-
- <para>In addition to the standard installation media which
- contains copies of all the &os; installation files, there is a
- <emphasis>bootonly</emphasis> variant. Bootonly install media
- does not have copies of the installation files, but downloads
- them from the network during an install. The bootonly install
- <acronym>CD</acronym> is consequently much smaller, and
- reduces bandwidth usage during the install by only downloading
- required files.</para>
+ <para>The &os; installer is not an application that can be run from
+ within another operating system. Instead, download a &os;
+ installation file, burn it to the media associated with its
+ file type and size (<acronym>CD</acronym>,
+ <acronym>DVD</acronym>, or <acronym>USB</acronym>), and boot
+ the system to install from the inserted media.</para>
- <para>Copies of &os; installation media are available at <link
+ <para>&os; installation files are available at <link
xlink:href="&url.base;/where.html#download">www.freebsd.org/where.html#download</link>.
- Also download <filename>CHECKSUM.SHA256</filename> from the
- same directory as the image file, and use it to check the
+ Each installation file's name includes the release version of
+ &os;, the architecture, and the type of file. For example, to
+ install &os; 10.0 on an &arch.amd64; system from a
+ <acronym>DVD</acronym>, download
+ <filename>FreeBSD-10.0-RELEASE-amd64-dvd1.iso</filename>,
+ burn this file to a <acronym>DVD</acronym>, and boot the
+ system with the <acronym>DVD</acronym> inserted.</para>
+
+ <para>Several file types are available, though not all file
+ types are available for all architectures. The possible file
+ types are:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para><literal>-bootonly.iso</literal>: This is the smallest
+ installation file as it only contains the installer. A
+ working Internet connection is required during
+ installation as the installer will download the files it
+ needs to complete the &os; installation. This file should
+ be burned to a <acronym>CD</acronym> using a
+ <acronym>CD</acronym> burning application.</para>
+ </listitem>
+
+ <listitem>
+ <para><literal>-disc1.iso</literal>: This file contains all
+ of the files needed to install &os;, its source, and the
+ Ports Collection. It should be burned to a
+ <acronym>CD</acronym> using a <acronym>CD</acronym>
+ burning application.</para>
+ </listitem>
+
+ <listitem>
+ <para><literal>-dvd1.iso</literal>: This file contains all
+ of the files needed to install &os;, its source, and the
+ Ports Collection. It also contains a set of popular
+ binary packages for installing a window manager and some
+ applications so that a complete system can be installed
+ from media without requiring a connection to the Internet.
+ This file should be burned to a <acronym>DVD</acronym>
+ using a <acronym>DVD</acronym> burning application.</para>
+ </listitem>
+
+ <listitem>
+ <para><literal>-memstick.img</literal>: This file contains
+ all of the files needed to install &os;, its source, and
+ the Ports Collection. It should be burned to a
+ <acronym>USB</acronym> stick using the instructions
+ below.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Also download <filename>CHECKSUM.SHA256</filename> from the
+ same directory as the image file and use it to check the
image file's integrity by calculating a
- <emphasis>checksum</emphasis>. &os; provides &man.sha256.1;
+ <firstterm>checksum</firstterm>. &os; provides &man.sha256.1;
for this, while other operating systems have similar programs.
Compare the calculated checksum with the one shown in
<filename>CHECKSUM.SHA256</filename>. The checksums must
match exactly. If the checksums do not match, the file is
- corrupt and should be discarded.</para>
+ corrupt and should be downloaded again.</para>
- <tip>
- <para>If a copy of &os; already exists on
- <acronym>CD</acronym>, <acronym>DVD</acronym>, or
- <acronym>USB</acronym> memory stick, this section can be
- skipped.</para>
- </tip>
+ <sect3>
+ <title>Burning an Image File to <acronym>USB</acronym></title>
- <para>&os; <acronym>CD</acronym> and <acronym>DVD</acronym>
- images are bootable <acronym>ISO</acronym> files. Only one
- <acronym>CD</acronym> or <acronym>DVD</acronym> is needed for
- an install. Burn the <acronym>ISO</acronym> image to a
- bootable <acronym>CD</acronym> or <acronym>DVD</acronym> using
- the burning applications available with the current operating
- system. On &os;, recording is provided by
- <command>cdrecord</command> from
- <package>sysutils/cdrtools</package>, installed from the Ports
- Collection.</para>
-
- <para>To create a bootable memory stick, follow these
- steps:</para>
-
- <procedure xml:id="bsdinstall-installation-media-memory-stick">
- <step>
- <title>Acquire the Memory Stick Image</title>
-
- <para>Memory stick images for &os; 9.0-RELEASE and
- later can be downloaded from the
- <filename>ISO-IMAGES/</filename>
- directory at
- <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable>arch</replaceable>/<replaceable>arch</replaceable>/ISO-IMAGES/<replaceable>version</replaceable>/&os;-<replaceable>version</replaceable>-RELEASE-<replaceable>arch</replaceable>-memstick.img</literal>.
- Replace <replaceable>arch</replaceable> and
- <replaceable>version</replaceable> with the architecture
- and the version number to install, respectively. For
- example, the memory stick images for
- &os;/&arch.i386; 9.0-RELEASE are available from <uri
- xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/&arch.i386;/ISO-IMAGES/9.0/&os;-9.0-RELEASE-&arch.i386;-memstick.img">ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/&arch.i386;/ISO-IMAGES/9.0/&os;-9.0-RELEASE-&arch.i386;-memstick.img</uri>.</para>
-
- <tip>
- <para>A different directory path is used for
- &os; 8.<replaceable>X</replaceable> and earlier
- versions. Details of download and installation of
- &os; 8.<replaceable>X</replaceable> and earlier is
- covered in <xref linkend="install"/>.</para>
- </tip>
-
- <para>The memory stick image has a <filename>.img</filename>
- extension. The <filename>ISO-IMAGES/</filename> directory
- contains a number of different images, and the one needed
- depends on the version of &os; being installed, and in
- some cases, the target hardware.</para>
+ <para>Since the <filename>*.img</filename> file is an
+ <emphasis>image</emphasis> of the complete contents of a
+ memory stick, it <emphasis>cannot</emphasis> just be copied
+ to the target device. Several applications are available
+ for burning the <filename>*.img</filename> to a
+ <acronym>USB</acronym> stick. This section describes two
+ of these utilities.</para>
<important>
- <para>Before proceeding, <emphasis>back up</emphasis> the
- data on the USB stick, as this procedure will
- <emphasis>erase</emphasis> it.</para>
+ <para>Before proceeding, back up any important
+ data on the <acronym>USB</acronym> stick as this procedure will
+ erase the existing data on the stick.</para>
</important>
- </step>
-
- <step>
- <title>Write the Image File to the Memory Stick</title>
<procedure>
- <title>Using &os; to Write the Image</title>
+ <title>Using <command>dd</command> to Write the
+ Image</title>
<warning>
- <para>The example below shows
+ <para>This example uses
<filename>/dev/da0</filename> as the target device
- where the image will be written. Be very careful that
- the correct device is used as the output target, as
- this command will destroy existing data.</para>
+ where the image will be written. Be <emphasis>very
+ careful</emphasis> that the correct device is used as
+ this command will destroy the existing data on the
+ specified target device.</para>
</warning>
<step>
- <title>Writing the Image with &man.dd.1;</title>
-
- <para>The <filename>.img</filename> file is
- <emphasis>not</emphasis> a regular file. It is an
- <emphasis>image</emphasis> of the complete contents of
- the memory stick. It <emphasis>cannot</emphasis> be
- copied like a regular file, but must be written
- directly to the target device with &man.dd.1;:</para>
-
- <screen>&prompt.root; <userinput>dd if=&os;-9.0-RELEASE-&arch.i386;-memstick.img of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
+ <para>The <command>dd</command> command-line utility is
+ included on BSD, Linux, and &macos; systems. To burn
+ the image using <command>dd</command>, insert the
+ <acronym>USB</acronym> stick and determine its device
+ name. Then, specify the name of the downloaded
+ installation file and the device name for the
+ <acronym>USB</acronym> stick. This example burns the
+ &arch.amd64; installation image to the first
+ <acronym>USB</acronym> device on an existing &os;
+ system.</para>
+
+ <screen>&prompt.root; <userinput>dd if=<replaceable>FreeBSD-10.0-RELEASE-amd64-memstick.img</replaceable> of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
+
+ <para>Should this command fail, verify that the
+ <acronym>USB</acronym> stick is not mounted and that
+ the device name is for the disk, not a partition.
+ Depending upon the operating system, this command may
+ need to be issued using
+ <command>sudo</command>.</para>
</step>
</procedure>
@@ -549,7 +559,7 @@
<warning>
<para>Be sure to give the correct drive letter as the
- output target, as existing data will be overwritten
+ existing data on the specified drive will be overwritten
and destroyed.</para>
</warning>
@@ -583,15 +593,9 @@
write the image file to the memory stick.</para>
</step>
</procedure>
- </step>
- </procedure>
-
- <note>
- <para>Installation from floppy disks is no longer
- supported.</para>
- </note>
<para>You are now ready to start installing &os;.</para>
+ </sect3>
</sect2>
</sect1>
More information about the svn-doc-head
mailing list