Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 05 Aug 2010 19:42:41 -0400
From:      Glen Barber <glen.j.barber@gmail.com>
To:        Marc Fonvieille <blackend@freebsd.org>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: docs/147347: [request] Missing memstick install setup instructions in Handbook
Message-ID:  <4C5B4C71.1020208@gmail.com>
In-Reply-To: <20100805190809.GA1537@gothic.blackend.org>
References:  <201007270230.o6R2U8sg085393@freefall.freebsd.org> <4C54A56E.2050808@gmail.com> <20100805190809.GA1537@gothic.blackend.org>

next in thread | previous in thread | raw e-mail | index | archive | help
This is a multi-part message in MIME format.
--------------090002080802030506010702
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi, Marc

On 8/5/10 3:08 PM, Marc Fonvieille wrote:
> On Sat, Jul 31, 2010 at 06:36:30PM -0400, Glen Barber wrote:
>> Hi,
>>
>> I've attached a new patch, which, pointed out by Warren Block off-list, 
>> instructs to set kern.geom.debugflags=16, making the USB device 
>> bootable.  I've also corrected my whitespace issues. :(
>>
>> -- 
>> Glen Barber
> 
> 
> Hello Glen,
> 
> Few comments:

[snip in-line comments]

Thank you very much for the feedback.  Please see the attached patch
which addresses the issues you mentioned.

Thanks again, and best regards.

- -- 
Glen Barber
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Darwin)

iQEcBAEBAgAGBQJMW0xxAAoJEFJPDDeguUajXi8H+wT+JCTx9+k2JoZgUla8L7pi
6iv2Szy64ISMhDOZ9X3mnboRN/FPDUdZPKTgfSmI4nO5pL4LWax7F7We0sXNqxwT
wlLhb0txMdjVhLkIo883/2FwwR1VcchI1QWn2j2KxVAzLM9y2tqzuYrM/WQlYzLS
w21m7jV3OQWyDskfgAqlLHdnwZrS9xi3qaDorAhxxj6qut3rxD2L2jjGEHM8/U70
okQ/Dl6u4NeQ1HvUUxLttUYPxZLVL7+555f/Gwgjbz02FlT0loPjjMb9vjOtgZDR
pL42V60rEgoxOLTXOIkuID5z6zv9hwmirFQXBoaPN6GuhMWUqRGnBmcxGVJ8++Y=
=kX34
-----END PGP SIGNATURE-----

--------------090002080802030506010702
Content-Type: text/plain;
 name="chapter.sgml.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="chapter.sgml.diff"

--- install/chapter.sgml.orig	2010-08-05 19:12:01.000000000 -0400
+++ install/chapter.sgml	2010-08-05 19:28:09.000000000 -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,7 +699,13 @@
       <procedure>
 	<step>
 	  <title>Acquire the Boot Floppy Images</title>
-	  
+
+	  <important>
+	    <para>Please note, as of &os; 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
 	    can also be downloaded from the floppies directory, <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable>&lt;arch&gt;</replaceable>/<replaceable>&lt;version&gt;</replaceable>-RELEASE/floppies/</literal>.
@@ -799,6 +809,66 @@
 	</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 class="directory">ISO-IMAGES/</filename> directory from
+	    <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable>&lt;arch&gt;</replaceable>/ISO-IMAGES/<replaceable>&lt;version&gt;</replaceable>/&rel.current;-RELEASE-&lt;arch&gt;-memstick.img</literal>.
+	    Replace <replaceable>&lt;arch&gt;</replaceable> and
+	    <replaceable>&lt;version&gt;</replaceable> with the architecture
+	    and the version number which you want to install, respectively.
+	    For example, the memory stick images for
+	    &os;/&arch.i386;&nbsp;&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 class="directory">ISO-IMAGES/</filename> directory
+	    contains a number of different images, and the one you will need
+	    to use will depend on the version of &os; 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 <filename>/dev/da0</filename> 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>Set the <literal>kern.geom.debugflags</literal> sysctl to be
+	  able to write a master boot record to the target device.</para>
+
+	  <screen><userinput>&prompt.root; sysctl kern.geom.debugflags=16</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 image
+	    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>

--------------090002080802030506010702--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4C5B4C71.1020208>