From 6c145d248c7d98d7de99d8a74c9976cc911a61c6 Mon Sep 17 00:00:00 2001
From: Joachim Nilsson <joachim@gnufans.org>
Date: Tue, 22 Mar 2005 22:45:00 +0000
Subject: none

---
 Distrib/CrossInstall.mdwn | 75 +++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 72 insertions(+), 3 deletions(-)

(limited to 'Distrib')

diff --git a/Distrib/CrossInstall.mdwn b/Distrib/CrossInstall.mdwn
index d78322f8..9a07424e 100644
--- a/Distrib/CrossInstall.mdwn
+++ b/Distrib/CrossInstall.mdwn
@@ -1,7 +1,76 @@
-Jeff Bailey has set up a system where you can install a Hurd system without having to use CDs. It's another type of cross-installation method which uses Debian package management tools to get the packages required as opposed to the one single big tarball.
+## <a name="Easy_install_with_CrossHurd"> Easy install with CrossHurd </a>
+
+Qurious about the Hurd? Have a 1-5 GiB partition free? Let's install GNU/Hurd on it!
+
+### <a name="Preparing_the_partition"> Preparing the partition </a>
+
+We'll assume you have a partition ready, for the sake of argument we use an example here: /dev/hda3 is the Hurd partition (type: Linux) and /dev/hda4 is the Linux swap that we'll reuse.
+
+First we create the Ext2 filesystem, notice the `hurd` option.
+
+    # mke2fs -o hurd /dev/DEVICE
+
+Next we create a useful mountpoint and mount the partition.
+
+    # mkdir /gnu
+    # mount /dev/hda3 /gnu
+
+### <a name="Retrieving_CrossHurd"> Retrieving CrossHurd </a>
+
+Unless you don't run Debian GNU/Linux download it from <http://packages.debian.org/crosshurd>, or simply apt-get the package from Testing or Unstable.
+
+    # apt-get install crosshurd
+
+### <a name="Cross_installing"> Cross installing </a>
+
+The crosshurd package only operates in the given target directory, which is the first question asked when running the program.
+
+    # cd /gnu
+    # crosshurd
+
+Answer the questions you get: $ What is the target directory?: `/gnu` $ Target Debian system?: gnu $ Target CPU?: i386
 
-As of 27.05.2004, the latest version of crosshurd is 1.6.2. It can be found in
+Now the program starts retrieving all the necessary base packages.
+
+### <a name="Preparing_to_reboot"> Preparing to reboot </a>
+
+When all packages have been extracted we must prepare [[GrubNotes]] for the Hurd when we reboot. Add the below entry to your `/boot/grub/menu.lst` file to boot the Hurd in single user mode (-s). Single user mode is needed only for the two reboots when running the Native Install.
+
+    title GNU (kernel GNUmach 1.3)
+      root (hd0,2)
+      kernel /boot/gnumach.gz root=device:hd0s3 -s
+      module /hurd/ext2fs.static                           \
+           --multiboot-command-line=${kernel-command-line} \
+           --host-priv-port=${host-port}                   \
+           --device-master-port=${device-port}             \
+           --exec-server-task=${exec-task}                 \
+           -T typed ${root} $(task-create) $(task-resume)
+      module /lib/ld.so.1 /hurd/exec $(exec-task=task-create)
+
+**_Nota Bene:_** In your menu file there should be no extra white space after the back slashes.
+
+### <a name="Native_install"> Native install </a>
+
+Ah, reboot and select "GNU (kernel GNUmach 1.3)" from the Grub menu. At the prompt, setup TERM and run the native-install script.
+
+    # export TERM=mach
+    # ./native-install
+
+When done the native install requests that you reboot once again and rerun native-install. This time you will be asked a lot of questions, see the [[Hurd/InstallNotes]] for details.
+
+    # reboot
+    ...
+    # export TERM=mach
+    # ./native-install
+
+Done, continue setting up your system, see the [[Hurd/InstallNotes]] for more help.
+
+-- [[Main/JoachimNilsson]] - 22 Mar 2005
+
+----
+
+Jeff Bailey has set up a system where you can install a Hurd system without having to use CDs. It's another type of cross-installation method which uses Debian package management tools to get the packages required as opposed to the one single big tarball.
 
-<http://packages.debian.org/unstable/misc/crosshurd>
+As of 2005-03-22, the latest version of crosshurd is 1.7.11. It can be found at <http://packages.debian.org/crosshurd>.
 
 -- [[Main/PeterMelville]] - 12 Jun 2004
-- 
cgit v1.2.3