summaryrefslogtreecommitdiff
path: root/release
diff options
context:
space:
mode:
Diffstat (limited to 'release')
-rw-r--r--release/INSTALL-binary151
1 files changed, 112 insertions, 39 deletions
diff --git a/release/INSTALL-binary b/release/INSTALL-binary
index 3cb1b8f4..c42c8655 100644
--- a/release/INSTALL-binary
+++ b/release/INSTALL-binary
@@ -13,26 +13,104 @@ Library General Public when distributing this binary snapshot. See
/share/misc/COPYING and /share/misc/COPYING.LIB for copies of these
licenses.
+If you have noticed that these steps are rather long and a bit too
+complex, you are right. But we didn't want to delay the release just
+in order to make the installation prettier. You can rest assured,
+however: Making it prettier and easier is one of our more important
+priorities.
+
STEP I:
+Fetch the file `grub-boot.image' from the FTP site. It should be
+in the same directory as the Hurd binary image tar file. Copy this
+file onto a fresh floppy with the command:
+ dd if=grub-boot.image of=/dev/fd0 bs=512
+This is your `grub boot floppy', referred to below.
+
Unpack the binary distribution onto a fresh disk partition, which needs
to be BSD FFS format. The boot loader we use (GRUB) does not yet
understand how to boot from a Linux ext2fs filesystem, though this is
expected to change very soon.
Make the disk partition with newfs or mkfs on your favorite BSD
-system. Then unpack the binaries with tar onto that partition.
+system. Then unpack the binaries with tar onto that partition. It is
+strongly suggested that you dedicate a new disk to the Hurd. If you
+have BSD, but you don't understand how to set up disks, it will
+probably be easier to use NetBSD boot floppies.
-[If you do not have a system running BSD, the NetBSD 2-floppy install
+If you do not have a system running BSD, the NetBSD 2-floppy install
set contains enough tools to make a new filesystem using newfs and
-copy to it from nfs.]
+copy to it from nfs. You can fetch these floppies from ftp.netbsd.org
+in the directory /pub/NetBSD/arch/i386/floppies. The NetBSD install
+script will start automatically when you boot from the floppies, and
+we suggest you use it in order to partition and set up your disk.
+
+We plan to have our own boot floppies soon.
+
+Here are detailed instructions for this step, assuming you are using
+NetBSD boot floppies, and you have the Hurd binary snapshot unpacked
+somewhere accessible via nfs. It is assumed here that your machine's
+network address is MY-ADDR and that the nfs server's address is
+SERVER-ADDR. The nfs mountpoint on the server is presumed to be
+SERVER-DIR. (MY-ADDR and SERVER-ADDR should be IP addresses in dot
+notation, not hostnames.) Your server and your new machine need to be
+on the same network.
+
+If you installing this way, you probably want to do STEP II first,
+because your nfs server probably has more convenient editors than the
+NetBSd boot floppies. The boot floppies have only ed.
+
+I.A. Fetch the netbsd boot floppies.
+I.B. Boot the `kernel' floppy, and switch to the `filesystem' floppy
+ when instructed.
+I.C. Proceed through the NetBSD automated installation script.
+ When you are asked if you want to view the boot messages again,
+ say yes. Then answer the disk geometry questions correctly,
+ copying from what was printed at boot time.
+I.D. Tell the script that you want to use cylinders, not sectors,
+ in specifying sizes.
+I.E. VERY IMPORTANT: Make the size of your `NetBSD' portion one
+ cylinder less than the total amount listed. If the script
+ tells you that you have 3045 cylinders, then say you want the
+ NetBSD portion to be 3044 cylinders long.
+I.F. VERY IMPORTANT: Tell the script that your `NetBSD' portion
+ should start at cylinder 1. Not 0. 1.
+I.G. Then allocate however much disk you want to your root partition
+ and to your swap partition. The root partition must be big
+ enough to hold the entire Hurd binary snapshot; it is strongly
+ recommended that you make it a fair bit bigger than that. It is
+ quite satisfactory to use only one filesystem partition in the
+ Hurd.
+I.H. If you specify partitions beyond the root partition and swap,
+ the script will ask you for a `mount point'. Type anything you
+ like, it won't matter.
+I.I. Affirm to the over-eagerly questioning script that you really do
+ want to smash your disk. NetBSD will proceed to create
+ filesystems on all the partitions you specified in I.G-H.
+I.J. When the script says "populating ..." hit ^C. You are now done
+ with the script.
+
+I.K. cd to /mnt. For each mount point that was gratuitously created
+ in step I.H, say `umount NAME'. Then say `rm -rf * .*'. Make
+ sure you are really in /mnt. This will delete whatever NetBSD
+ has put on your new partition.
+I.L. Initialize the network with `ifconfig DEV MY-ADDR'. DEV was
+ printed by the kernel when it booted; type `more /kern/msgbuf'
+ if you want to see those messages again. (Sometimes ifconfig
+ says that something is "offline". Ignore it.)
+I.M. Mount the NFS server partition with the conveniente command
+ `mount SERVER-ADDR:SERVER-DIR /mnt2'.
+I.N. Copy the Hurd onto your disk with the command
+ (cd /mnt2; tar cf - .) | (cd mnt; tar xfpv -)
+I.O. Don't shutdown NetBSD yet. If you haven't done STEP II yet,
+ then do it now; otherwise go on to STEP III.
+
-
STEP II:
-You probably need to change the device on which paging is done. This
-is done in a file in the Hurd partition called `boot/servers.boot', on
+You might need to change the device on which paging is done. This is
+done in a file in the Hurd partition called `boot/servers.boot', on
the line which looks like:
/dev/sd0b $(add-paging-file) $(default-pager)
@@ -42,38 +120,17 @@ name (this is a mach partition name), or comment out the line if you
don't want paging. Note that you don't have to do anything to
initialize swap partitions, unlike Linux.
-You also need to edit the file boot/boot-menu.grub. Change both root
-specifications to match your partition. Note that these
-specifications say `hd' for scsi disks, and have a slightly different
-syntax.
-
-Fsck and unmount the new partition before using it, to make sure it's
-clean.
STEP III:
-Install the grub bootloader.
-
-The instructions for installing grub are found in INSTALL-grub, which
-is a copy of the installation instructions at
-http://www.uruk.org/grub.
-
-We have included binaries for the various pieces of grub in /boot/grub
-on your Hurd partition. So you can follow the grub installation
-instructions without needing to build the actual grub pieces.
-
-You may want to switch to using grub entirely; it is able to most
-other kernels too. Full instructions are available on at
-http://www.uruk.org/grub, or in the grub source (which you should find
-wherever you picked up this binary release).
-
-
-
-STEP IV:
-
-Boot the system with grub. You should get a grub boot menu with two
-entries, `hurd' and `hurd-single'. Select hurd-single.
+You can now boot the Hurd. Boot the grub boot floppy. When the menu
+comes up, select one of the single user boot commands, depending on
+whether you have a SCSI disk (sd0) or an IDE type disk (hd0). If you
+put the Hurd on something other than partition `a', then you will need
+to edit the boot commands appropriately before booting. (Editing the
+commands using grub only affects what you boot that time, it does not
+affect what the floppy does the next time you boot it.)
Mach should load, and then the Hurd should start, saying something like:
@@ -82,7 +139,7 @@ Mach should load, and then the Hurd should start, saying something like:
bash#
-STEP V:
+STEP IV:
When GNU boots the first time, you might see some confusing messages,
and you may notice that pipes don't work.
@@ -94,7 +151,7 @@ Hurd system, say
This will set up some initial translators so that the system runs
normally, and then offer to reboot the system. When it comes back up,
-boot it single-user again, so that you can do step VI.
+boot it single-user again, so that you can do step V.
NOTE: Do NOT RUN BSD FSCK on a Hurd FFS!
@@ -112,13 +169,29 @@ NOTE: Do NOT RUN BSD FSCK on a Hurd FFS!
extensions.)
+STEP V:
+
+If you want to be able to boot this disk without using the floppy each
+time, then run the script /INSTALL-GRUB-MBR; give it the arg the name
+of your disk without any partition. Something like
+
+/INSTALL-GRUB-MBR sd0
+
+is called for.
+
+The menu that grub provides is found in /boot/grub/menu.lst. You can
+edit that file to change what options the menu provides. (You can
+change the one on the floppy by mounting the filesystem it contains
+and editing the file there.)
+
+
STEP VI:
Now you have a Hurd system. But in order to make it fully usable, do
the following:
-*** making devices
+*** make devices
cd to /dev and make devices.
Say `MAKEDEV dev1 dev2 dev3 ...'.
@@ -159,7 +232,7 @@ nameserver to work properly.
-*** mounting partitions
+*** mount partitions
You can mount a partition (say hd0a) by saying:
@@ -185,7 +258,7 @@ You can make it readonly thus:
For more information on settrans, see the end of this file.
-*** mounting nfs
+*** mount nfs
NFS mounts, not surprisingly, are done thus: