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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
-----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-----
[-- Attachment #2 --]
--- 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>
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4C5B4C71.1020208>