en/install-methods/boot-usb-files.xml

<!-- retain these comments for translator revision tracking -->
<!-- $Id$ -->

 <sect1 condition="bootable-usb" id="boot-usb-files">
 <title>Preparing Files for USB Memory Stick Booting</title>

<para>

For preparing the USB stick you will need a system where GNU/Linux is
already running and where USB is supported. You should ensure that the
usb-storage kernel module is loaded (<userinput>modprobe
usb-storage</userinput>) and try to find out which SCSI device the USB
stick has been mapped to (in this example
<filename>/dev/sda</filename> is used). To write to your stick, you
will probably have to turn off its write protection switch.

</para><para>

Note, that the USB stick should be at least 128 MB in size (smaller
setups are possible if you follow <xref linkend="usb-copy-flexible"/>).

</para>

  <sect2 id="usb-copy-easy">
  <title>Copying the files - the easy way</title>
<para arch="i386">

There is an all-in-one file <filename>hd-media/boot.img.gz</filename>
which contains all the installer files (including the kernel) as well
as <command>SYSLINUX</command> and its configuration file. You only
have to extract it directly to your USB stick:

<informalexample><screen>
# gzip -dc boot.img.gz &gt; /dev/<replaceable>sda</replaceable>
</screen></informalexample>

Of course this will destroy anything already on the device, so take
care that you use the correct device name for your USB stick.

</para><para arch="powerpc">

There is an all-in-one file <filename>hd-media/boot.img.gz</filename>
which contains all the installer files (including the kernel) as well
as <command>yaboot</command> and its configuration file. Create a
partition of type "Apple_Bootstrap" on your USB stick using
<command>mac-fdisk</command>'s <userinput>C</userinput> command and
extract the image directly to that:

<informalexample><screen>
# gzip -dc boot.img.gz &gt; /dev/<replaceable>sda2</replaceable>
</screen></informalexample>

Of course this will destroy anything already on the device, so take
care that you use the correct device name for your USB stick.

</para><para>

After that, mount the USB memory stick (<userinput>mount
<replaceable arch="i386">/dev/sda</replaceable>
<replaceable arch="powerpc">/dev/sda2</replaceable>
/mnt</userinput>), which will now have
<phrase arch="i386">a FAT filesystem</phrase>
<phrase arch="powerpc">an HFS filesystem</phrase>
on it, and copy a Debian netinst or businesscard ISO image to it.
Please note that the file name must end in <filename>.iso</filename>.
Unmount the stick (<userinput>umount /mnt</userinput>) and you are done.

</para>
  </sect2>

  <sect2 id="usb-copy-flexible">
  <title>Copying the files - the flexible way</title>
<para>

If you like more flexibility or just want to know what's going on, you
should use the following method to put the files on your stick.

</para>

&usb-setup-i386.xml;
&usb-setup-powerpc.xml;

   <sect3>
   <title>Adding an ISO image</title>
<para>

Now you should put any Debian ISO image (businesscard, netinst or even
a full one) onto your stick (if it fits). The file name of such an
image must end in <filename>.iso</filename>.

</para><para>

If you want to install over the network, without using an ISO image,
you will of course skip the previous step. Moreover you will have to
use the initial ramdisk from the <filename>netboot</filename>
directory instead of the one from <filename>hd-media</filename>,
because <filename>hd-media/initrd.gz</filename> does not have network
support.

</para><para>

When you are done, unmount the USB memory stick (<userinput>umount
/mnt</userinput>) and activate its write protection switch.

</para>
   </sect3>

   <!-- TODO: doesn't this section belong later? -->
   <sect3 arch="i386">
   <title>Booting the USB stick</title>
<warning><para>

If your system refuses to boot from the memory stick, the stick may
contain an invalid master boot record (MBR). To fix this, use the
<command>install-mbr</command> command from the package
<classname>mbr</classname>:

<informalexample><screen>
# install-mbr /dev/<replaceable>sda</replaceable>
</screen></informalexample>

</para></warning>
   </sect3>
  </sect2>
 </sect1>
1	mck-guest	10377	<!-- retain these comments for translator revision tracking -->
2	joeyh	11648	<!-- $Id$ -->
3	mck-guest	10377
4			<sect1 condition="bootable-usb" id="boot-usb-files">
5			<title>Preparing Files for USB Memory Stick Booting</title>
6
7			<para>
8
9			For preparing the USB stick you will need a system where GNU/Linux is
10	fjpop-guest	22664	already running and where USB is supported. You should ensure that the
11	mck-guest	10377	usb-storage kernel module is loaded (<userinput>modprobe
12			usb-storage</userinput>) and try to find out which SCSI device the USB
13			stick has been mapped to (in this example
14			<filename>/dev/sda</filename> is used). To write to your stick, you
15			will probably have to turn off its write protection switch.
16
17			</para><para>
18
19	mck-guest	10519	Note, that the USB stick should be at least 128 MB in size (smaller
20			setups are possible if you follow <xref linkend="usb-copy-flexible"/>).
21	mck-guest	10377
22			</para>
23
24			<sect2 id="usb-copy-easy">
25			<title>Copying the files - the easy way</title>
26	cjwatson	24616	<para arch="i386">
27	mck-guest	10377
28			There is an all-in-one file <filename>hd-media/boot.img.gz</filename>
29			which contains all the installer files (including the kernel) as well
30	cjwatson	24616	as <command>SYSLINUX</command> and its configuration file. You only
31			have to extract it directly to your USB stick:
32	mck-guest	10377
33	mck-guest	10519	<informalexample><screen>
34	fjpop-guest	24663	# gzip -dc boot.img.gz > /dev/<replaceable>sda</replaceable>
35	mck-guest	10519	</screen></informalexample>
36
37	cjwatson	24616	Of course this will destroy anything already on the device, so take
38			care that you use the correct device name for your USB stick.
39
40			</para><para arch="powerpc">
41
42			There is an all-in-one file <filename>hd-media/boot.img.gz</filename>
43			which contains all the installer files (including the kernel) as well
44			as <command>yaboot</command> and its configuration file. Create a
45			partition of type "Apple_Bootstrap" on your USB stick using
46	cjwatson	24602	<command>mac-fdisk</command>'s <userinput>C</userinput> command and
47			extract the image directly to that:
48	mck-guest	10519
49	mck-guest	10377	<informalexample><screen>
50	fjpop-guest	24663	# gzip -dc boot.img.gz > /dev/<replaceable>sda2</replaceable>
51	mck-guest	10377	</screen></informalexample>
52
53	cjwatson	24602	Of course this will destroy anything already on the device, so take
54			care that you use the correct device name for your USB stick.
55	mck-guest	10377
56			</para><para>
57
58	cjwatson	24602	After that, mount the USB memory stick (<userinput>mount
59	cjwatson	24616	<replaceable arch="i386">/dev/sda</replaceable>
60			<replaceable arch="powerpc">/dev/sda2</replaceable>
61	cjwatson	24602	/mnt</userinput>), which will now have
62			<phrase arch="i386">a FAT filesystem</phrase>
63			<phrase arch="powerpc">an HFS filesystem</phrase>
64			on it, and copy a Debian netinst or businesscard ISO image to it.
65			Please note that the file name must end in <filename>.iso</filename>.
66			Unmount the stick (<userinput>umount /mnt</userinput>) and you are done.
67	mck-guest	10377
68	cjwatson	24602	</para>
69			</sect2>
70	mck-guest	10377
71	cjwatson	24602	<sect2 id="usb-copy-flexible">
72			<title>Copying the files - the flexible way</title>
73			<para>
74	mck-guest	10377
75	cjwatson	24602	If you like more flexibility or just want to know what's going on, you
76			should use the following method to put the files on your stick.
77	mck-guest	10377
78	cjwatson	24602	</para>
79	mck-guest	10377
80	cjwatson	24602	&usb-setup-i386.xml;
81			&usb-setup-powerpc.xml;
82	mck-guest	10377
83	cjwatson	24602	<sect3>
84			<title>Adding an ISO image</title>
85			<para>
86	mck-guest	10377
87	mck-guest	10519	Now you should put any Debian ISO image (businesscard, netinst or even
88	mck-guest	10377	a full one) onto your stick (if it fits). The file name of such an
89	mck-guest	10519	image must end in <filename>.iso</filename>.
90	mck-guest	10377
91			</para><para>
92
93	mck-guest	10519	If you want to install over the network, without using an ISO image,
94			you will of course skip the previous step. Moreover you will have to
95			use the initial ramdisk from the <filename>netboot</filename>
96			directory instead of the one from <filename>hd-media</filename>,
97			because <filename>hd-media/initrd.gz</filename> does not have network
98			support.
99
100			</para><para>
101
102	mck-guest	10377	When you are done, unmount the USB memory stick (<userinput>umount
103			/mnt</userinput>) and activate its write protection switch.
104
105	cjwatson	24602	</para>
106			</sect3>
107	mck-guest	10519
108	cjwatson	24602	<!-- TODO: doesn't this section belong later? -->
109			<sect3 arch="i386">
110			<title>Booting the USB stick</title>
111			<warning><para>
112
113	mck-guest	10519	If your system refuses to boot from the memory stick, the stick may
114			contain an invalid master boot record (MBR). To fix this, use the
115			<command>install-mbr</command> command from the package
116			<classname>mbr</classname>:
117
118			<informalexample><screen>
119	fjpop-guest	24663	# install-mbr /dev/<replaceable>sda</replaceable>
120	mck-guest	10519	</screen></informalexample>
121
122			</para></warning>
123	cjwatson	24602	</sect3>
124	mck-guest	10377	</sect2>
125			</sect1>