Date: Tue, 20 Jul 2010 09:31:18 -0400 From: Glen Barber <glen.j.barber@gmail.com> To: doc@FreeBSD.org Subject: Re: docs/147347: [patch][handbook] Request for comments on memstick install instructions Message-ID: <4C45A526.1010209@gmail.com> In-Reply-To: <4C4580C2.5080000@gmail.com> References: <4C44F9D3.9060009@gmail.com> <alpine.BSF.2.00.1007192214230.71753@wonkity.com> <4C4580C2.5080000@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
This is a multi-part message in MIME format.
--------------030103090907030709050109
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
On 7/20/10 6:56 AM, Glen Barber wrote:
>
> Now, when I had done my USB install, I had a problem where the USB stick
> was not bootable until I zeroed the first 1k blocks. I did have previous
> data on the device, which perhaps was the problem. dd-ing the .img to
> the device wrote the information as expected; I just could not boot from
> it. I left this part in, as I personally ran into this, though I removed
> labeling and newfs-ing.
>
In addition to the above change, I missed a few </para> tags. The
attached patch has this fixed.
Regards,
--
Glen Barber
--------------030103090907030709050109
Content-Type: text/plain; x-mac-type="0"; x-mac-creator="0";
name="handbook.install.sgml.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
filename="handbook.install.sgml.diff"
--- handbook/install/chapter.sgml.orig 2010-07-19 17:03:42.763886000 -0400
+++ handbook/install/chapter.sgml 2010-07-20 08:44:18.609955721 -0400
@@ -630,6 +630,10 @@
</listitem>
<listitem>
+ <para>A USB Memory Stick</para>
+ </listitem>
+
+ <listitem>
<para>A DOS partition on the same computer</para>
</listitem>
@@ -695,6 +699,13 @@
<procedure>
<step>
<title>Acquire the Boot Floppy Images</title>
+
+ <important>
+ <para>Please note, as of &os; release 8.0, floppy disk
+ images are no longer available. Please see below for
+ instructions on how to install &os; using a USB memory
+ stick.</para>
+ </important>
<para>The boot disks are available on your installation media
in the <filename>floppies/</filename> directory, and
@@ -799,6 +810,70 @@
</step>
</procedure>
+ <para>To create a bootable memory stick, follow these steps:</para>
+
+ <procedure>
+ <step>
+ <title>Acquire the Memory Stick Image</title>
+
+ <para>The memory stick image can be downloaded from the
+ <filename>ISO-IMAGES/</filename> directory from
+ <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable><arch></replaceable>/ISO-IMAGES/<replaceable><version></replaceable>/&rel.current;-RELEASE-<arch>-memstick.img</literal>.
+ Replace <replaceable><arch></replaceable> and
+ <replaceable><version></replaceable>
+ with the architecture and the version number
+ which you want to install, respectively.
+ For example, the memory stick images for
+ &os;/&arch.i386; &rel.current;-RELEASE are available
+ from <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/ISO-IMAGES/&rel.current;/&rel.current;-RELEASE-&arch.i386;-memstick.img"></ulink>.</para>;
+
+ <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 ones you will need to use depends on the
+ version of FreeBSD you are installing, and in some cases, the
+ hardware you are installing to.</para>
+
+ <important>
+ <para>Before proceeding, <emphasis>back up</emphasis> the
+ data you currently have on your USB stick, as this
+ procedure will <emphasis>erase</emphasis> it.</para>
+ </important>
+ </step>
+
+ <step>
+ <title>Prepare the Memory Stick</title>
+
+ <warning>
+ <para>The example below lists <literal>/dev/da0</literal>
+ as the target device from which you will be booting. Be
+ very careful that you have the correct device as the
+ output target, or you may destroy your existing
+ data.</para>
+ </warning>
+
+ <para>Replacing <replaceable>da0</replaceable> with the
+ device your memory stick shows up as, erase the current
+ data from the memory stick.</para>
+
+ <screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/<replaceable>da0</replaceable> bs=1k count=1</userinput></screen>
+ </step>
+
+ <step>
+ <title>Write the Image File to the Memory Stick</title>
+
+ <para>The <filename>.img</filename> file is
+ <emphasis>not</emphasis> a regular file you copy to the
+ memory stick. It is an image of the complete contents of
+ the disk. This means that you <emphasis>cannot</emphasis>
+ simply copy files from one disk to another. Instead, you
+ must use &man.dd.1; to write the images directly to the
+ disk:</para>
+
+ <screen>&prompt.root; <userinput>dd if=&rel.current;-RELEASE-&arch.i386;-memstick.img of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
+
+ </step>
+ </procedure>
+
<para>You are now ready to start installing FreeBSD.</para>
</sect2>
</sect1>
--------------030103090907030709050109--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4C45A526.1010209>