From nobody@FreeBSD.org  Thu Jun  3 01:16:16 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 7522B106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  3 Jun 2010 01:16:16 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 657858FC12
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  3 Jun 2010 01:16:16 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o531GF9X006321
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 3 Jun 2010 01:16:15 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o531GE9c006317;
	Thu, 3 Jun 2010 01:16:14 GMT
	(envelope-from nobody)
Message-Id: <201006030116.o531GE9c006317@www.freebsd.org>
Date: Thu, 3 Jun 2010 01:16:14 GMT
From: Luke <lukek@linux.ca>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Missing memstick install setup instructions in Handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         147347
>Category:       docs
>Synopsis:       [request] Missing memstick install setup instructions in Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 03 01:20:03 UTC 2010
>Closed-Date:    Sat Aug 07 08:54:38 UTC 2010
>Last-Modified:  Sat Aug  7 09:00:16 UTC 2010
>Originator:     Luke
>Release:        FreeBSD8-RELEASE-i386
>Organization:
na
>Environment:
FreeBSD8-RELEASE-i386
>Description:
I am trying to install a fresh 8-RELEASE using the memstick.iso but unsure how to actually put it on the USB stick. Did some digging in the forums and found some helpful info. Wondering if this info could be added to the handy-dandy handbook?




>How-To-Repeat:
na
>Fix:
probable places to update might be as follows:
2.3.6
Under "Local Media", could add "USB memstick" tot he list of possible install media.

2.3.7
This section could maybe explain how to 'dd' the USB memstick image in preparation for boot/install.
Specifically the following command (Not sure if this is the best way):
dd if=/dev/md0 of=/dev/da0 bs=1m

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->suspended 
State-Changed-By: linimon 
State-Changed-When: Tue Jun 15 01:44:18 UTC 2010 
State-Changed-Why:  
marked suspended awating patches.  (This sounds like a good idea to me.) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=147347 

From: Andrey Fesenko <f0andrey@gmail.com>
To: bug-followup@FreeBSD.org, lukek@linux.ca
Cc:  
Subject: Re: docs/147347: [request] Missing memstick install setup 
	instructions in Handbook
Date: Sun, 27 Jun 2010 10:15:16 +0400

 If you use FreeBSD < 8.0 make image
 http://bsdimp.blogspot.com/2007/10/building-bootable-freebsdi386-images.html,
 maybe fdisk change at gpart.
 If use FreeBSD >= 8.0 simple"dd if=8.0-RELEASE-amd64-memstick.img
 of=/dev/da0 bs=1m".
 Some flash did not have time to be determined, at startup, must
 modification system.

From: Glen Barber <glen.j.barber@gmail.com>
To: bug-followup@FreeBSD.org, lukek@linux.ca
Cc:  
Subject: Re: docs/147347: [request] Missing memstick install setup instructions
 in Handbook
Date: Tue, 20 Jul 2010 21:11:59 -0400

   Hello,
 
 I've submitted a patch to doc@ for comments.  The original thread is here:
 
      http://lists.freebsd.org/pipermail/freebsd-doc/2010-July/017383.html
 
 Feedback welcome.
 
 Regards,
 
 -- 
 Glen Barber
 

From: Glen Barber <glen.j.barber@gmail.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/147347: [request] Missing memstick install setup instructions
 in Handbook
Date: Mon, 26 Jul 2010 22:25:37 -0400

 This is a multi-part message in MIME format.
 --------------060203040505040401030906
 Content-Type: text/plain; charset=ISO-8859-1; format=flowed
 Content-Transfer-Encoding: 7bit
 
   Hi,
 
 I haven't received as much feedback as I would have liked on the patch I 
 submitted to doc@, so I will put it out in the open with the original PR.
 
 Regards,
 
 -- 
 Glen Barber
 
 
 --------------060203040505040401030906
 Content-Type: text/plain;
  name="chapter.sgml.txt"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="chapter.sgml.txt"
 
 --- 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>&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>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>
 
 --------------060203040505040401030906--

From: Glen Barber <glen.j.barber@gmail.com>
To: bug-followup@FreeBSD.org, lukek@linux.ca
Cc: Marc Fonvieille <blackend@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>&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>
 
 --------------010002080307020400060302--
State-Changed-From-To: suspended->closed 
State-Changed-By: blackend 
State-Changed-When: Sat Aug 7 08:53:52 UTC 2010 
State-Changed-Why:  
Thanks.  I committed a slightly modified version of Glen's patch. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=147347 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/147347: commit references a PR
Date: Sat,  7 Aug 2010 08:53:47 +0000 (UTC)

 blackend    2010-08-07 08:53:39 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/install chapter.sgml 
   Log:
   Add pre-installation tasks relative to the USB memstick.  Inform the
   reader that installation floppies are no longer available for 8.X and
   above.
   
   PR:             docs/147347 and docs/149230
   Patch submitted by:     Glen Barber <glen.j.barber@gmail.com>
   
   Revision  Changes    Path
   1.399     +81 -3     doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
