1. DESCRIPTION:

These are the files/directories needed for PXE booting.


2. CONTENTS:

README
	This file

freebsd/
	kernel/MFS for a PXE-booted memory based FreeBSD system.
	We use this MFS for creating disk images and general maintenance
	tasks on a node (e.g., when the node's disk is scrogged).  The
	MFS contains a pretty small set of utilities.

frisbee/
	kernel/MFS for a PXE-booted memory based FreeBSD system.
	This MFS is considerably smaller than the "freebsd" one.  It is
	used to reload node disks with frisbee.  Since it may be loaded
	simultaneously by many nodes to reload their disks, we wanted
	this to be as small as possible.  Not intended as an interactive
	environment, its rc.local script invokes frisbee and then reboots.

freebsd.newnode/
	kernel/MFS for a PXE-booted memory based FreeBSD system.
	A specialized version of the frisbee MFS for loading on nodes
	which are not yet part of Emulab.

pxeboot
	The standard PXE-booted startup.  Loaded by every node whenever
	they reboot.  It is a specialized, stripped-down version of the
	FreeBSD boot loader.

pxeboot.freebsd
pxeboot.frisbee
pxeboot.newnode
	Programs downloaded by PXE in order to bootstrap the various
	MFSes.  These are not variants of "pxeboot" above but are each
	just versions of the standard FreeBSD pxeboot with a path changed
	to reflect the appropriate "root" directory.


3. INSTALLATION:

If you are reading this file, then I guess you have succeeded in unpacking
the tarball.  Hopefully, you have unpacked it into /tftpboot.  If not, go
do that now, I'll wait...

...ok.  Things will work with what you have just unpacked, but to make them
more efficient, you should go into the various */boot directories and run the
prepare script there.  All this script does is create gzip'ed version of the
various files that are needed to bootstrap the MFS-based system.  This will
speed up the boot process considerably:

	foreach d in (freebsd frisbee freebsd.newnode)
	(cd $d/boot ; sudo ./prepare)
	end


4. MODIFYING AN MFS:

If you want to see what is in one of the MFSes or otherwise customize it,
you simply mount the MFS as a filesystem.  This takes two steps in BSD:
associating a "virtual disk" with the file and then mounting that disk,
e.g. as root:

	vnconfig vn0 /tftpboot/frisbee/boot/mfsroot
	mount /dev/vn0c /mnt

When you are done, just unmount the filesystem and rerun the prepare
script:

	umount /dev/vn0c
	cd /tftpboot/frisbee/boot; ./prepare

If you aren't going to do any more mods for a while, then you can
unconfigure the disk as well:

	vnconfig -u vn0

though this isn't necessary in order for your changes to make it into
the MFS that is downloaded (it *is* essential that you rerun the prepare
script above or else the node will continue to download mfsroot.gz instead
of your updated mfsroot).

Note that you may have to create vnode-disk devices in /dev:

	cd /dev; ./MAKEDEV vn0 vn1


5. INSTALLING A NEW KERNEL:

The kernel which drives the MFS-based system is not part of the MFS itself.
So to install a new kernel, you do not have to do the MFS nonsense above.
You just have to stick your kernel into /tftpboot/blah-blah/boot, ala:

	cp kernel /tftpboot/frisbee/boot
	cd /tftpboot/frisbee/boot; ./prepare

Again, it is important to rerun prepare.