docs/147347: [request] Missing memstick install setup instructions in Handbook

[Glen Barber]

The following reply was made to PR docs/147347; it has been noted by GNATS.

From: Glen Barber <glen.j.barber at gmail.com>
To: bug-followup at FreeBSD.org, lukek at linux.ca
Cc: Marc Fonvieille <blackend at FreeBSD.org>
Subject: Re: docs/147347: [request] Missing memstick install setup instructions
 in Handbook
Date: Fri, 06 Aug 2010 10:17:59 -0400

 This is a multi-part message in MIME format.
 --------------010002080307020400060302
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
  The attached patch, discussed on doc@, adds instructions on creating a
 bootable memory stick installer.
 
 -- 
 Glen Barber
 
 
 --------------010002080307020400060302
 Content-Type: text/plain;
  name="chapter.sgml.txt"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="chapter.sgml.txt"
 
 --- 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><arch></replaceable>/<replaceable><version></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><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 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>
 
 --------------010002080307020400060302--