move manual to top-level directory, split out of debian-installer package

2 files changed, 212 insertions, 0 deletions

diff --git a/en/install-methods/usb-setup/i386.xml b/en/install-methods/usb-setup/i386.xml
new file mode 100644
index 000000000..a1b89606f
--- /dev/null
+++ b/en/install-methods/usb-setup/i386.xml
@@ -0,0 +1,101 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id$ -->
+
+   <sect3 arch="i386">
+   <title>USB stick partitioning on &arch-title;</title>
+<para>
+
+We will show how to setup the memory stick to use the first partition,
+instead of the entire device.
+
+</para><note><para>
+
+Since most USB sticks come pre-configured with a single FAT16
+partition, you probably won't have to repartition or reformat the
+stick.  If you have to do that anyway, use <command>cfdisk</command>
+or any other partitioning tool for creating a FAT16 partition and then
+create the filesystem using:
+
+<informalexample><screen>
+# mkdosfs /dev/<replaceable>sda1</replaceable>
+</screen></informalexample>
+
+Take care that you use the correct device name for your USB stick. The
+<command>mkdosfs</command> command is contained in the
+<classname>dosfstools</classname> Debian package.
+
+</para></note><para>
+
+In order to start the kernel after booting from the USB stick, we will
+put a boot loader on the stick. Although any boot loader
+(e.g. <command>LILO</command>) should work, it's convenient to use
+<command>SYSLINUX</command>, since it uses a FAT16 partition and can
+be reconfigured by just editing a text file. Any operating system
+which supports the FAT file system can be used to make changes to the
+configuration of the boot loader.
+
+</para><para>
+
+To put <command>SYSLINUX</command> on the FAT16 partition on your USB
+stick, install the <classname>syslinux</classname> and
+<classname>mtools</classname> packages on your system, and do:
+
+<informalexample><screen>
+# syslinux /dev/<replaceable>sda1</replaceable>
+</screen></informalexample>
+
+Again, take care that you use the correct device name. The partition
+must not be mounted when starting <command>SYSLINUX</command>. This
+procedure writes a boot sector to the partition and creates the file
+<filename>ldlinux.sys</filename> which contains the boot loader code.
+
+</para><para>
+
+Mount the partition (<userinput>mount /dev/sda1 /mnt</userinput>) and
+copy the following files from the Debian archives to the stick:
+
+<itemizedlist>
+<listitem><para>
+
+<filename>vmlinuz</filename> (kernel binary)
+
+</para></listitem>
+<listitem><para>
+
+<filename>initrd.gz</filename> (initial ramdisk image)
+
+</para></listitem>
+<listitem><para>
+
+<filename>syslinux.cfg</filename> (SYSLINUX configuration file)
+
+</para></listitem>
+<listitem><para>
+
+Optional kernel modules
+
+</para></listitem>
+</itemizedlist>
+
+If you want to rename the files, please note that
+<command>SYSLINUX</command> can only process DOS (8.3) file names.
+
+</para><para>
+
+The <filename>syslinux.cfg</filename> configuration file should
+contain the following two lines:
+
+<informalexample><screen>
+default vmlinuz
+append initrd=initrd.gz ramdisk_size=12000 root=/dev/rd/0 init=/linuxrc rw
+</screen></informalexample>
+
+Please note that the <userinput>ramdisk_size</userinput> parameter
+may need to be increased, depending on the image you are booting.
+<phrase condition="sarge">
+If the boot fails, you can try adding <userinput>devfs=mount,dall</userinput>
+to the <quote>append</quote> line.
+</phrase>
+
+</para>
+   </sect3>
diff --git a/en/install-methods/usb-setup/powerpc.xml b/en/install-methods/usb-setup/powerpc.xml
new file mode 100644
index 000000000..12e1284b9
--- /dev/null
+++ b/en/install-methods/usb-setup/powerpc.xml
@@ -0,0 +1,111 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id$ -->
+
+   <sect3 arch="powerpc">
+   <title>USB stick partitioning on &arch-title;</title>
+<para>
+
+Most USB sticks do not come pre-configured in such a way that Open
+Firmware can boot from them, so you will need to repartition the stick.
+On Mac systems, run <userinput>mac-fdisk /dev/sda</userinput>,
+initialise a new partition map using the <userinput>i</userinput>
+command, and create a new partition of type Apple_Bootstrap using the
+<userinput>C</userinput> command. (Note that the first "partition" will
+always be the partition map itself.) Then type
+
+<informalexample><screen>
+$ hformat /dev/<replaceable>sda2</replaceable>
+</screen></informalexample>
+
+Take care that you use the correct device name for your USB stick. The
+<command>hformat</command> command is contained in the
+<classname>hfsutils</classname> Debian package.
+
+</para><para>
+
+In order to start the kernel after booting from the USB stick, we will
+put a boot loader on the stick. The <command>yaboot</command> boot
+loader can be installed on an HFS filesystem and can be reconfigured by
+just editing a text file. Any operating system which supports the HFS
+file system can be used to make changes to the configuration of the boot
+loader.
+
+</para><para>
+
+The normal <command>ybin</command> tool that comes with
+<command>yaboot</command> does not yet understand USB storage devices,
+so you will have to install <command>yaboot</command> by hand using the
+<classname>hfsutils</classname> tools. Type
+
+<informalexample><screen>
+$ hmount /dev/sda2
+$ hcopy -r /usr/lib/yaboot/yaboot :
+$ hattrib -c UNIX -t tbxi :yaboot
+$ hattrib -b :
+$ humount
+</screen></informalexample>
+
+Again, take care that you use the correct device name. The partition
+must not be otherwise mounted during this procedure. This procedure
+writes the boot loader to the partition, and uses the HFS utilities to
+mark it in such a way that Open Firmware will boot it. Having done this,
+the rest of the USB stick may be prepared using the normal Unix
+utilities.
+
+</para><para>
+
+Mount the partition (<userinput>mount /dev/sda2 /mnt</userinput>) and
+copy the following files from the Debian archives to the stick:
+
+<itemizedlist>
+<listitem><para>
+
+<filename>vmlinux</filename> (kernel binary)
+
+</para></listitem>
+<listitem><para>
+
+<filename>initrd.gz</filename> (initial ramdisk image)
+
+</para></listitem>
+<listitem><para>
+
+<filename>yaboot.conf</filename> (yaboot configuration file)
+
+</para></listitem>
+<listitem><para>
+
+<filename>boot.msg</filename> (optional boot message)
+
+</para></listitem>
+<listitem><para>
+
+Optional kernel modules
+
+</para></listitem>
+</itemizedlist>
+
+</para><para>
+
+The <filename>yaboot.conf</filename> configuration file should
+contain the following lines:
+
+<informalexample><screen>
+default=install
+root=/dev/ram
+
+message=/boot.msg
+
+image=/vmlinux
+        label=install
+        initrd=/initrd.gz
+        initrd-size=10000<phrase condition="sarge">
+        append="devfs=mount,dall --"</phrase>
+        read-only
+</screen></informalexample>
+
+Please note that the <userinput>initrd-size</userinput> parameter
+may need to be increased, depending on the image you are booting.
+
+</para>
+   </sect3>