Linux Remote-Boot mini-HOWTO:      Configuring Remote-Boot Worksta�
  tions    with Red-Hat Linux, DOS, Windows 3.1 and Windows 95
  Marc Vuilleumier St�ckelberg, Sandro Viale and David Clerc
  v2.5, August 1997

  This document describes how to set up a very robust server-based con�
  figuration for a cluster of PCs, allowing each client to choose at
  boot-time which operating system to run. The key of this configuration
  is the TCP/IP bootprom, which let the user choose at boot time one of
  several boot images. The most up-to-date version of this document,
  with hypertext links to downloadable software and other related mate�
  rials, can be found at the address
  http://cuiwww.unige.ch/info/pc/remote-boot/howto.html.  Linuxdoc-SGML,
  DVI and postscript versions are available in the same directory.

  1.  What has changed...

  1.1.

  A lot of things:

  �  The Linux server-based configuration and documentation have been
     completely redesigned. It is now based on RedHat Linux 4.1, updated
     to the 2.0.30 kernel. Linux system setup and maintenance has been
     much simplified.

  �  The Dos and Windows configurations have been completely redesigned,
     using a "hard-disk based" approach. This makes the configuration
     MUCH easier, fasten the boot process, reduces the network load, and
     even allows for a server-based setup of Windows NT station
     (although this is not described in this document).

  �  We now use a DHCP server, with standard DHCP/BOOTP extensions (RFC
     2132).

  �  This configuration now works also with Samba, the free SMB server,
     instead of a Novell server. In fact, we are now on the point of
     throwing away of our Novell server...

  1.2.

  A new banner feature has been added to the bpunzip utility.  A bug in
  MRZIP, which caused "Bad compressed data" errors during disk image
  decompression, has been found and fixed.

  Several precisions were added to the documentation. Links to related
  software (Shared LAN Cache) and documentation (from J. Carlstedt, of
  The Cathedral School of Uppsala, Sweden) have also been added.

  2.  Introduction

  The configuration described here was developped since Summer 1996 at
  the CUI, University of Geneva. The Computer Science Department uses
  several servers (both Unix and Novell), and a number of PCs, which
  fall into two classes:

  �  computers devoted to students

  �  computers devoted to research and teaching assistants

     We developped the current configuration with the following aims:

  �  Every computer should be able to run under Linux, DOS, Windows 3.1
     or Windows 95. One should be able to choose the desired operating
     system for each session.

  �  All softwares, including operating systems, should reside on the
     server, in order to facilitate the installations and upgrades.

  �  Clients computers should be able to run without any write-access on
     the server (for security reasons), except their home directory.

  �  Client-side configuration should be reduced to its very minimum.
     Clients should automatically get their IP configuration parameters
     from the server, and this information should be located in a single
     file, used for all operating systems.

  �  Since almost every computer now has a hard-disk, clients should be
     able to take profit of it for reducing network load and as
     temporary storage space for the user.

  �  Users must have a login to be able to use any of the computers.

  �  The login should be the same for all operating system and should
     let the user access its unique home directory, common to all
     operating systems.

  �  Students computers should be fully cleaned up at each start. That
     is, the PC should always look like if it were just installed.

  �  Every computer has to be protected from virus attacks.

     These constraints lead us to base our configuration on the
     excellent TCP/IP Bootprom from K�ppen EDV GmbH.  This bootprom is
     especially interesting because it is not devoted to any specific
     operating system; it just emulates a floppy disk, and can easily be
     used for booting Linux as well as DOS or Windows 95.  Moreover, the
     bootdisk image can be replaced by a home-made program, that let us
     perform several initializations before the operating system itself
     starts.

  2.1.  The Network

  The University of Geneva owns a class B domain, subdivided into
  several subnets. The CUI uses four subnets, among them one is
  dedicated to students.

  Originally, our PCs were concerned about two network protocols: IPX
  and IP.  On the IPX side, we used a single Novell Netware 3 server for
  sharing software and users files for DOS and Windows. On the IP side,
  we used a SUN server for sharing software and users partitions for
  Linux, with NFS.

  In our latest configuration, we do not any more use IPX. There is a
  single Unix server (which could be Linux as well as a SUN), sharing
  software and user files using NFS for Linux clients and using SMB
  (NetBIOS) over TCP/IP for Dos and Windows clients.

  2.2.  How it Works

  1. When a client PC is turned on, it first performs the traditional
     system checks before the TCP/IP bootprom takes the control.

  2. The bootprom issues a BOOTP/DHCP request in order to get its IP
     configuration parameters.
  3. If the server knows the PC issuing the request, it will send back a
     BOOTP/DHCP reply with informations such as the client's IP address,
     the default gateway, and which bootdisk image to use.  Otherwise,
     the server will just discard the request.

  4. The bootprom then downloads the bootdisk image from the server
     using the TFTP protocol, and emulates at the BIOS level a floppy
     disk with this image.

  5. The PC boot on this disk image, which happens to contains a single
     boot program (no operating system yet).

  6. If the PC is a student computer, the program starts by downloading
     by TFTP a small text file containing the expected hard-disk
     configuration for the computer. According to this file, the
     partition table is rebuilt and DOS partitions are quick-formatted.
     When all this is done, no more than three seconds have elapsed
     since the computer was turned on.

  7. The program then offers to the user the choice of the operating
     system for the session.

  8. According to the choice of the user, a new bootdisk image is
     downloaded from the server, using TFTP.

  9. If the user decides to use Linux, the boot image is a a kernel
     loader plus a compressed kernel, with support for NFS root and
     caching filesystem:

     a. First, the IP configuration is made according to the BOOTP/DHCP
        reply received from the Novell server.

     b. The kernel is then able to mount a read-only root filesystem,
        using NFS.

     c. A small ramdisk is set up and mounted to the places where write
        access is desirable.

     d. If a swap partition is found on the local hard disk, it is
        prepared and activated.

     e. If a linux partition is found on the local hard disk, it is
        mounted and prepared for caching NFS partitions.

     f. IP configuration is finalized, services are started, and xdm is
        launched.

     g. The user is asked for its login. The workstation is ready.

  10.
     If the user decides to use DOS or Windows, the boot image is a
     program that handle compressed images of FAT16 partitions.  Images
     are downloaded using TFTP, and stored for further use at the very
     end of the hard-disk, above any used partition.  More precisely,
     the program works in the following way:

     a. The program download a checksum file (512 bytes) that validates
        the boot image of the choosen operating system

     b. If the wanted image is not present at the end of the disk, or if
        the checksum does not match (because the image has been
        corrupted or because a new release has been installed on the
        server), the full image is transferred using TFTP.

     c. The operating system image is decompressed into the first FAT16
        partition, at the approximate speed of one second per used
        megabyte.

     d. The program jump into the boot sector of the selected OS, which
        is now completely present on the local hard-disk.

     For DOS and Windows 3.1, we use the freely available Microsoft Lan�
     Manager for DOS (search the network for the mirror nearest to you;
     the distribution consists of three files named disk1 to disk4) as
     SMB client. Microsoft LanManager supports dynamic configuration
     using DHCP. After logging in, the user is faced to DOS, and can
     start Windows 3.1 by typing the traditional win command. Note that
     at this point, DOS and Windows 3.1 appear to be installed locally.

     For Windows 95, we also use Microsoft SMB client (called Client for
     the Microsoft Network), that supports dynamic configuration using
     DHCP. We reduce network load using Shared LAN Cache, a nice and
     powerful network-to-disk cache program.

     Students computers can be turned off the hard way at any time with�
     out risks, since the hard disk is reinitialized at each start.

  For "safe" computers (ie. for assistants computers), once the computer
  has been booted once using the above described system, the boot image
  can be changed to a simple program that redirect the boot to the local
  hard-disk, without cleaning it again. This allow users to leave data
  on their local hard disk. But whenever the configuration gets
  corrupted, it is sufficient to change the boot image for one start in
  order to get a fresh installation.

  2.3.  Related non-commercial documentations

  This configuration has been successfully reproduced at several places
  around the world. A few people have written some hints and tricks that
  complement this How-To. If you did so and that your page is not
  already referenced in this documentation, please send an e-mail to
  Marc.VuilleumierStuckelberg@cui.unige.ch.  And if you experience
  problems while reproducing this configuration, have a look at these
  pages !

  �  http://www.katedral.se/system/elevsyst, by Johan Carlstedt of The
     Cathedral School of Uppsala, Sweden.

  3.  The Configuration How-To

  First, arrange to have the following two machines within arm's reach:

  �  the server, for us a Unix machine

  �  the client, a PC with a TCP/IP bootprom enabled, and nothing
     valuable on the hard disk.

     If you want to test the configuration but you do not yet have a
     TCP/IP Bootprom, you can download the demo diskette from
     http://www.incom.de.  This diskette will make your computer behave
     like if it had a TCP/IP Bootprom plugged in.

  For student computers, we configured our Bootprom for boot on network
  first, and disabled hard-disk and floppy-disk boot. For assistant
  computers, we also configured our Bootprom for network-boot, but we
  allow hard-disk and floppy-disk boot; use this kind of Bootprom in
  your setup client.

  On the server, setup a DHCP daemon (we use the official version from
  the Internet Software Consortium, release 970329).  You also need to
  enable a TFTP daemon. This document assume that you use the extended
  TFTP daemon provided on your TCP/IP Bootprom Utility disk. If you
  prefer to use a standard TFTP daemon, remove the P in all boot image
  name extensions, in order to tell the Bootprom to use only the
  standard TFTP port (see the TCP/IP Bootprom documentation).

  Don't forget that BOOTP/DHCP requests are bounded by subnets. If the
  client and the server do not reside on the same subnet, you should
  install a gateway on any computer between the two. For now, just
  assume that both machines are on the same subnet.

  First, we will do everything common to all operating systems, ie:

  �  Configure the initial hard-disk setup and cleaning

  �  Configure the operating system choice menu

  �  Test the boot process

     Then, for each operating system, we will go through the following
     steps:

  �  Setup a stand-alone client

  �  Save its configuration on the server

  �  Test it as a remote-boot client

  �  Adapt it so that it works for any similar client machine

     Once this is done, you will be able to setup any supplemental
     client just by plugging a BootPROM in it and adding a few lines in
     the DHCP configuration file.

  3.1.  Setting Up the Boot Process

  In the server /tftpboot directory, put the following special boot
  images (warning for hypertext readers: these are binary files)

  �  bpclean, our hard-disk cleaning utility

  �  bpmenu, the TCP/IP Bootprom menu program (included with your
     bootprom utility disk)

  �  bpunzip, our hard-disk restore utility

  �  bphdboot, the image that redirect the boot process to the hard disk

  3.1.1.  The Initial Hard-disk Setup and Cleaning

  In the same directory, create a symbolic link to (or make a copy of)
  bpclean named XXXclean (or whatever you want that that can help you
  remember that it is a clean-up image for your client machine) and
  create a text file named XXXclean.tab describing what partition table
  you want for your client, and what boot image you want to chain.  For
  instance, for a 2 Gb hard-disk, we use

  ______________________________________________________________________
  # Comments are allowed, but file should not exceed 512 bytes
  # Hex numbers should be prefixed by $

  # Part |       |  Part
  # type | Boot? |  Size
     6      Y       +500 Mb
    $82     N       +31 Mb
    $83     N       -50 Mb
     0

  # Bootimage to chain
  /tftpboot/XXXmenu
  ______________________________________________________________________

  The precise format of the file is described later in this document.
  For now, all you need to know is that

  �  partition type 6 is BIGDOS, ie. DOS Fat-16 from 32Mb to 500Mb

  �  partition type hex 82 is Linux Swap

  �  partition type hex 83 is Linux Ext2fs

  �  the negative size means that we partition three should occupy all
     available space but 50 Mb

  �  partition type 0 means empty (unused) partition entry.

     For now, bpclean will not erase the content of any partition but
     rewrite the master boot record, including the partition table.

  3.1.2.  The Operating System Choice Menu

  Similarly, create a symbolic link to (or make a copy of) bpmenu named
  XXXmenu (or whatever you want that that can help you remember that it
  is a boot menu image for your client machine) and create a text file
  named XXXmenu.m containing the boot menu for your machine. You might
  either create this file by hand, or use our menuedit.exe full-screen
  menu editor. For the example, assume that you use the following file:

       ______________________________________________________________________
       ______________________________________________________________________

  3.1.3.  Testing the Boot Process

  Create an entry in the DHCP configuration file for your client.  Set
  the boot image to /tftpboot/XXXclean.  You will probably need to
  restart the DHCP server to take your changes into account.

  Now, start your client. You should quickly see messages from bpclean,
  telling you the size of the partitions created, and then the boot menu
  should appear on your screen. You can use the pause key on the
  keyboard just before the menu is loaded in order to be able to read
  the messages, but it will probably time-out the TFTP connection.

  If you press the key 1, you should get a message saying that the boot
  partition contains not valid boot sector.  This is normal since the
  boot partition has not been formatted.  Any other keys should fail
  since we did not make any boot image for now...

  We will now install the various operating systems.  You can do that in
  what order you want.  For each OS, you will initially need to start it
  from a boot floppy.  In order to do that, just press the space bar at
  the very beginning of the boot process, just after the TCP/IP Bootprom
  banner.

  Some operating system might change the master boot record. In
  particular, the Linux kernel loader (lilo) does that.  Such changes
  would be destroyed by bpclean, so you should better change the DHCP
  entry for your client so that the boot image is directly
  /tftpboot/XXXmenu (no clean).  Don't forget to restart the DHCP server
  to take your changes into account.

  3.2.  Setting Up Linux

  Set up RedHat Linux 4.1 on your client, with network support, kernel
  sources and any packages you may want.  Prepare future moint points (a
  /mnt/tmp will be usefull), setup your X server, and so on.  In the
  directory /usr/src/linux-2.0.27, you should have the source code for
  the kernel 2.0.27.

  We will now apply some patches, in order to upgrade to 2.0.30, and to
  support the TCP/IP Bootprom and the filecache.  The filecache is the
  mechanism by which you can reduce network loading by saving "on-the-
  fly" NFS files on your local hard disk.  TCP/IP Bootprom support has
  been written by Marc Vuilleumier Stuckelberg, and ported to kernel 2.0
  by David Clerc. The filecache has been written by Unifix GmbH, and is
  part of Unifix Linux 2.0. Both TCP/IP Bootprom support and the
  filecache have been made freely distributable by their authors.

  Note that Linux NFS-Root support is still based on BOOTP, not DHCP.
  But since DHCP is just an extension of BOOTP, Linux will work as well
  with a DHCP server (if you did not configure your DHCP server to deny
  BOOTP requests).

  3.2.1.  Building the Kernel

  First, go to your /usr/src directory and apply the following patches,
  using the command

  patch -p0 < the-patch-file:

  �  patch-2.0.28: this is the official kernel update, a big patch that
     you should better apply

  �  patch-config-sound: a cosmetic patch for the sound configuration,
     taken from Unifix Linux 2.0

  �  patch-PCSP: a rather big patch for adding soundcard emulation using
     the PC speaker, taken from Unifix Linux 2.0

  �  patch-bootprom: a small patch that will let you produce a special
     kernel image, usable as a boot image with the TCP/IP Bootprom

  �  patch-filecache: a small patch that adds special functionalities to
     your kernel, so that you can use Unifix filecache. Taken from
     Unifix Linux 2.0

  �  patch-penguinlogo: a small patch that will help your end-users to
     wait until your Linux system is completely loaded

  �  patch-2.0.29: another official kernel update patch, much smaller.
     You do not need to apply this patch if you don't want to have the
     latest kernel release.

  �  patch-2.0.30: yet another official kernel update patch, quite big.
     Again, you do not need to apply this patch (but it improves
     TCP/IP). If you do not have sources for the alpha on your machine
     (which is most probable), this patch will complain twice about an
     include file that does not exist. Do not worry, just answer that
     you want to skip the missing file and everything will be okay.

     Then run make mrproper and make xconfig, to customize the contents
     of your kernel.  Remember that this will be the only software the
     client computer will be given for starting Linux, so it must
     contains everything necessary to launch the whole operating system.
     Modules should be used, but not for networking support since the
     network is needed to load the kernel modules. In brief, your kernel
     should contains at least

  �  networking support

  �  NFS-Root support, with BOOTP support

  �  filecache support

  �  support for the client computer hardware, possibly modular

     You may use our .config as a starting point. Ensure that you have
     included support for your hard disk directly in the kernel if you
     want to be able to test it without the bootprom.

  When you are done with your choices, type the usual make clean; make
  dep and then make zImage, make modules and make modules_install. This
  will take a while...  You are now ready to test your new kernel, first
  using lilo.  Install your kernel (see lilo documentation), and reboot
  your computer (from the local hard disk).  If there are any errors,
  fix them and try again.  Run depmod -a to compute the modules
  dependencies.  When there are no more errors, do a make bpImage to
  build a bootimage for use with the TCP/IP Bootprom.

  3.2.2.  Moving the Root Filesystem to NFS

  Have enough place on your server to hold the whole content of your
  Linux filesystem (some hundred Megabytes).  Create a new directory for
  NFS export, named rootfs, and create another new directory within it
  named runtime.  We use /export/linux/rootfs/runtime. Export it read-
  write, with root access (annon=0), for your Linux client only. For
  instance, our NFS server is running under Solaris, and we gave the
  command:

  share -F nfs -o rw=pc7971,anon=0 /export/linux/rootfs/runtime.

  Mount this partition on your Linux client and copy the whole Linux
  system on it using GNU tar (the default on RedHat Linux).  It is
  important that you use GNU tar because all tar might not be able to
  handle correctly special nodes such as block devices.  Then edit the
  /export/linux/rootfs/runtime/etc/fstab file and change the entry for
  the root directory so that it corresponds to an nfs mount instead of a
  local hard disk. You also need to remove (or at least rename)
  /export/linux/rootfs/runtime/etc/sysconfig/network-scripts/ifcfg-eth0
  since the network device will be initialized by NFS-root and should
  not be initialized twice.
  Now duplicate the linux entry in your /etc/lilo.conf, using the name
  linux-nfs for instance, and add the following parameter to it:

  append="root=/dev/nfs nfsroot=/export/linux/rootfs/runtime
  nfsaddrs=your-ip:server-ip:gateway-ip:netmask:machine-name"

  (where your-ip is the decimal dotted notation for your Linux client IP
  address, server-ip is the NFS server IP address, gateway-ip is the
  default gateway used by the Linux machine, netmask is the netmask and
  machine-name is the hostname of the Linux machine).  Run lilo again,
  reboot your computer (still from the hard disk), and choose linux-nfs
  boot settings. Your computer should behave almost as before, although
  probably slower. If something doesn't work at this point, you can
  simply reboot with your local linux boot configuration and try to fix
  it. Most probably, you made the NFS root settings wrong.  If there is
  something you don't understand, have a look at the
  /usr/src/linux/Documentation files...  You might also look at the NFS-
  Root-Mini-Howto.

  You can repeat the experience with only append="root=/dev/nfs" to
  ensure that the Linux kernel is able to get your IP parameters using a
  DHCP/BOOTP request. For this to work, you should have the following
  options in your DHCP configuration file (set with your own values, of
  course), in addition to your machine hardware and IP addresses:

       ______________________________________________________________________
       option subnet-mask 255.255.252.0;
       option routers 129.194.68.1;
       option root-path "/export/linux/rootfs";
       ______________________________________________________________________

  If your Linux kernel needs additional command-line parameters, you can
  add them using option option-177.

  The next step is to have our system work with a read-only NFS
  filesystem.

  3.2.3.  Building the Read-only NFS Root Filesystem

  Since we want our root filesystem to be mounted read-only by regular
  linux clients, we have to make a slightly different filesystem, so
  that we can put a ramdisk or a filecache on places where write access
  is desirable.  We will build this filesystem in the
  /export/linux/rootfs directory, so that the standard distribution is
  directly available under /runtime/.  Log on your NFS server and create
  the following directories and links, under /export/linux/rootfs:

  �  bin -> cache/bin

  �  dev -> ramdisk/dev

  �  etc -> ramdisk/etc

  �  lib -> cache/lib

  �  root -> ramdisk/root

  �  sbin -> cache/sbin

  �  tmp -> ramdisk/tmp

  �  usr -> cache/usr

  �  var -> ramdisk/var

  �  cache/

  �  bin -> /runtime/bin

  �  lib -> /runtime/lib

  �  sbin -> /runtime/sbin

  �  usr -> /runtime/usr

  �  mnt/

  �  cdrom/

  �  floppy/

  �  tmp/

  �  proc/

  �  ramdisk/

  �  dev -> /runtime/dev

  �  etc -> /runtime/etc

  �  root -> /runtime/root

  �  tmp -> /runtime/tmp

  �  var -> /runtime/var

     As you can see, it looks like a regular root filesystem, except
     that some entries are redirected to a ramdisk, while some other are
     redirected to the cache directory.  When booting on a read-only NFS
     filesystem, we will mount an initialized ramdisk on /ramdisk.
     Similarly, a local hard disk partition will be mounted on /cache
     for caching NFS requests.  Roughly, the principle of the filecache
     is that whenever a symbolic link from the cache subdirectory is
     followed, it is replaced by its target. If the target is itself a
     subdirectory, each entry of the subdirectory becomes a symbolic
     link to the original entry of the foreign filesystem. Note that it
     is necessary for the filecache to use absolute symbolic links, even
     if they are meaningless on the NFS server. If you don't like that,
     create a symbolic link from /runtime to
     /export/linux/rootfs/runtime on your NFS server.

  It is then necessary to add some setup stuff to the read-only client,
  in order to mount the ramdisk, to setup the filecache and to detect
  hardware in order to customize the configuration files.  This is done
  by three scripts and one configuration file, that you should copy to
  your NFS server:

  �  runtime/etc/rc.d/rc.ramdisk, which quickly setup and mount the
     ramdisk:

  ______________________________________________________________________
  #!/bin/sh
  #
  # Setup a ramdisk because root was mounted read-only by NFS
  #
  modprobe rd
  gzip -c -d /runtime/lib/ramdisk.gz | dd of=/dev/ram bs=1k > /dev/null 2>&1
  mount -n -t ext2 /dev/ram /ramdisk
  ______________________________________________________________________

  �  runtime/etc/rc.d/rc.sysdetect, which does all machine-dependant
     configuration, including detecting and preparing local hard disk
     partitions for the filecache. It is not included in the printed
     version of this document for space reasons, but can be found in the
     hypertext version;

  �  runtime/etc/rc.d/init.d/filecache.init which starts the filecache
     itself:

       ______________________________________________________________________
       #!/bin/sh
       #
       # filecache:    Starts the filecache (for NFS root)
       #

       # Source function library.
       \&. /etc/rc.d/init.d/functions

       # See how we were called.
       case "$1" in
         start)
               if [ -e /cache -a -r /etc/filecache.conf ]; then
                       echo -n "Starting NFS filecache: "
                       # move var and tmp to the local hard drive
                       rm -rf /cache/var /cache/tmp
                       (cd /ramdisk; tar cf - var tmp) | (cd /cache; tar xf -)
                       (cd /ramdisk; rm -rf var tmp;ln -s /cache/var;ln -s /cache/tmp
       )
                       chmod 777 /cache/tmp
                       # start cache
                       daemon filecache -d on
                       echo ""
                       touch /var/lock/subsys/filecache
               fi
               ;;
         stop)
               filecache off
               rm -f /var/lock/subsys/filecache
               ;;
         *)
               echo "*** Usage: filecache.init {start|stop}"
               exit 1
       esac

       exit 0
       ______________________________________________________________________

  �  runtime/etc/filecache.conf, the filecache configuration file

  ______________________________________________________________________
  Max 100 MB 50 % #
  Cache /runtime /cache
  ______________________________________________________________________

  The first two files should be invoked at the beginning of run�
  time/etc/rc.d/rc.sysinit, as follow:

       ______________________________________________________________________
       # Setup ramdisk if necessary (for read-only root NFS)
       if [ -e /ramdisk -a -r /etc/rc.d/rc.ramdisk ]; then
               /etc/rc.d/rc.ramdisk
       fi

       # Setup hardware dependent parameters (for any root NFS)
       if [ -r /etc/rc.d/rc.sysdetect ]; then
               /etc/rc.d/rc.sysdetect
       fi
       ______________________________________________________________________

  and the third one should be bound as usual to the System V init direc�
  tories: we use links named S35filecache in the rc3.d and rc5.d direc�
  tories, and K80filecache in the rc0.d, rc1.d, rc2.d and rc6.d directo�
  ries.

  Take a look at the rc.sysdetect file, and adapt it to your hardware.
  In particular, if you do not use the same video adapters and screen as
  we do (which is very likely :-), see how they report to /proc/pci and
  modify the script according to that.  There is a section of
  rc.sysdetect with customize configuration files (for instance the
  printcap), according to the machine location. For this to work, you
  need to set each machine location using the special tag option-132 of
  the server dhcpd.conf file.  Before you continue this installation,
  you must at least build basic runtime/etc/fstab.ref and
  runtime/etc/hosts.ref files, which will be finalized by the
  rc.sysdetect script on boot time, according to the detected
  configuration.  For dynamically configuring the X server, there is one
  thing you have to change from the RedHat distribution: in the
  /usr/X11R6/bin and /usr/X11R6/lib/X11 directories, there are a few
  relative links to configuration files and directories that should be
  changed to absolute links. Don't forget to do that again if you
  reinstall later an upgrade of the X server.

  Install the filecache in runtime/bin, and its man page in
  runtime/usr/man/man8.  Install bootptag in runtime/usr/local/bin, and
  bootptag.c in runtime/usr/local/src: it is a simple program that
  issues a BOOTP request and answer its content on the standard output,
  in a shell-compatible format, as in the following example:

  ______________________________________________________________________
  bootp_your_ip='129.194.71.32'
  bootp_server_ip='129.194.77.31'
  bootp_filename='XXXclean'
  bootp_subnet_mask='255.255.252.0'
  bootp_routers='129.194.68.1'
  bootp_domain_name_servers='129.194.69.200 129.194.8.7 129.194.4.32'
  bootp_host_name='pc7132'
  bootp_domain_name='unige.ch'
  bootp_root_path='/export/linux/rootfs'
  bootp_broadcast_address='129.194.71.255'
  bootp_nis_domain='cuisunnet.unige.ch'
  bootp_nis_servers='129.194.69.200'
  bootp_option_132='dufour'
  ______________________________________________________________________

  The name of the tags is similar to that used in the dhcpd configura�
  tion file. We use this program for auto-configuration in rc.sysdetect.
  Finally, install the makeramdisk script in runtime/lib. We will use it
  to build automatically the ramdisk image. All these software are
  available in the hypertext version of this document.

  Now try to boot your read-write NFS client (still boot from the hard
  disk).  It should detect your local configuration, and generate the
  appropriate files. Check that /etc/fstab, /etc/hosts,
  /etc/sysconfig/network have been created correctly. If it is not the
  case, retry in single user mode, and debug the rc.sysdetect script to
  discover what you have done wrong.

  When it works, go to the /lib directory and run ./makeramdisk.  This
  will take a few seconds, and build a ramdisk image for the read-only
  NFS clients. Install the created ramdisk image under /lib/ramdisk.gz,
  and your configuration is ready !

  3.2.4.  Booting from the Bootprom

  If you did not already do it, install your TCP/IP Bootprom-compliant
  kernel image (found in /usr/src/linux/arch/i386/boot/bpImage) as
  /tftpboot/linux.PX on your server.  The rc.sysdetect script is able to
  initialize for you the Linux swap and a Linux data partition. In order
  to trigger it, edit the XXXclean.tab file on the server and change the
  partitions types from hex 82 to hex 28, and from hex 83 to hex 38.
  This is not a known partition type, but it will be recognized by the
  setup script as partitions to prepare.  In the DHCP configuration
  file, set the boot file to XXXclean again, in order to rebuild the
  partition table.  Do not forget to restart the DHCP daemon after you
  changed the configuration file.

  Finally, unexport the read-write runtime directory, and export read-
  only the /export/linux/rootfs directory. Restart the client, and this
  time boot using the Linux menu option.  Your system will now remote-
  boot Linux.

  3.2.5.  System Maintenance and Upgrades

  If you want later to upgrade software, install bug fixes and security
  fixes, proceed as follow:

  �  Unexport the rootfs directory

  �  Export the runtime directory read-write for your client

  �  Set your client nfsroot directory to runtime (in the /etc/bootptab)

  �  Start your Linux client, and install everything you want.  Do not
     be afraid of using rpm, it works perfectly well (just be carefull
     when you install packages that might alter modifications that you
     have made yourself).

  �  Redo the normal export when you are done

     That means, you can upgrade software on your server-based
     configuration as if it were a local install.

  3.3.  Setting up DOS 6 and Windows 3.1

  On the client computer, boot on your favorite dos floppy disk
  (remember, abort the BootPROM by pressing space during boot).  Format
  the dos partition of your hard-drive with the /S option, in order to
  put the operating system on it.  Create a DOS subdirectory, copy DOS
  in it. Install your favorite network client (for instance Microsoft
  LanManager), Windows 3.1, and so on. Use DHCP for the IP
  configuration.

  You should recover the memory used by the BootPROM (since it is not
  any more needed when the DOS starts) by inserting the following line
  at the beginning of your config.sys:

       ______________________________________________________________________
       device=\util\bputil.sys -r
       ______________________________________________________________________

  (bputil is a program provided on the TCP/IP Bootprom utility disk).
  Do not be afraid to use EMM386 to optimize the memory usage, and even
  to include the area where you put your network adapter ROM, since it
  is not used anymore at this time. But carefully exclude the network
  adapter RAM, or you will not be able to connect to your server.

  If you want to ensure that the client machine cannot be used without a
  valid login name, include our nobreak.sys pseudo-device driver at the
  beginning of your config.sys and put something like this in your
  autoexec.bat:

       ______________________________________________________________________
       rem -- we use the dummy file c:\logged as a flag
       del c:\logged >nul
       :loginneeded
       cls
       echo Please type in your login name and password
       echo.
       net logon *
       rem -- the login script should have created c:\logged
       if not exist c:\logged goto loginneeded
       del c:\logged
       rem -- now enable break again
       echo Yes >NOBRK
       ______________________________________________________________________

  Ensure that your client boot well by rebooting and choosing the Boot
  from local hard-disk option in the boot menu.

  3.3.1.  Moving the Configuration to the Server

  On the server, make a share called admin for instance, on which you
  will put some stuff for the system administrator.  If the server is a
  Unix machine, it is a good opportunity to put in admin a softlink to
  the /tftpboot subdirectory, so that you can put images in it directly
  from the client.  Within admin, create a /utils subdirectory and put
  the following utilities in it:

  �  mrzip.exe, a program that will create a compressed image of your
     hard disk.

  �  mrunzip.exe, a program that can restore from within DOS a
     compressed image of your hard disk.

     You might also like to put in the same directory a simple batch
     file that does some clean-up and then create the compressed image,
     like this one:

       ______________________________________________________________________
       @echo off
       if "%1"=="" goto error
       echo >c:\lanman.dos\lmuser.ini
       l:\utils\mrzip l:\tftpboot\%1
       goto end
       :error
       echo Usage: MAKEIMG {image-name-without-extension}
       :end
       ______________________________________________________________________

  Now go back to your client, mount the admin volume on drive L: for
  instance and execute either your batch file if you have created one,
  or the following command (absolute path names are not required, but
  they do not hurt :-)

       ______________________________________________________________________
               L:\util\mrzip L:\tftpboot\win31
       ______________________________________________________________________

  One minute later, you will have two new files in your server /tftpboot
  subdirectory, namely win31.imz, the compressed image of your hard disk
  and win31.chk, the associated checksum file (which is in fact a
  slightly modified copy of the partition boot record).  In this very
  directory, just create a symbolic link to (or a copy of) bpunzip named
  win31.P.

  Your disk-based remote-boot configuration is now ready.

  3.3.2.  Testing the Remote-Boot Client

  Now reboot your client and choose the DOS and Windows 3.1 option of
  the boot menu. The bpunzip program shall give you some message about
  his creating an image table, and then download the whole boot image
  from the network (since it is the first time that it sees this boot
  image). This will take about one minute.  Then it will uncompress the
  image to the DOS partition, and boot it. Here you are, your remote-
  boot client is ready !  Next time you reboot it, it will only
  uncompress the image, probably in less than 30 seconds.

  3.3.3.  Adapting the configuration for other Machines

  If you want to customize some settings according to the machine, to
  its location (such as the default printer), or if you need to make
  some changes in your network configuration files that cannot be
  handled through DHCP, you can use the unzipreg.exe program from within
  the client autoexec.bat.  This program will read a special hidden file
  created by bpunzip, namely BOOTP.ANS, that contains the original
  BOOTP/DHCP reply sent by the server. Then, it will read the file given
  as first argument, substitute all strings of the form
  UNZIPREG:tagname: by their content in the BOOTP/DHCP reply and write
  the result on the file given as second argument. For instance, if you
  have a file named input.bat which contains:

       ______________________________________________________________________
       set domainname=UNZIPREG:DOMAINNAME:
       set printer=UNZIPREG:T180:
       ______________________________________________________________________

  and you execute the command

       ______________________________________________________________________
               unzipreg input.bat output.bat
       ______________________________________________________________________

  you will get a file output.bat containing:

       ______________________________________________________________________
       set domainname=unige.ch
       set printer=laserwriter1
       ______________________________________________________________________

  assuming that your DHCP configuration file defines the domain name as
  unige.ch and the option-180 tag as laserwriter1.

  Note that it is also possible to customize the Windows desktop
  according to the login. We wrote a simple program to add a group to
  the PROGMAN.INI file, allowing to customize the desktop for each group
  of users.

  After making any change to the client machine configuration, do not
  forget to rebuild the disk image using mrzip if you want to preserve
  your changes.

  3.4.  Setting up Windows 95

  In previous versions of this document, we used the Microsoft server-
  based installation of Windows 95, but it was really too much pain and
  not much worth:

  �  It is very, very bogus

  �  Many software package do not support it and their install will
     fail.  Among them, Microsoft Internet Explorer, OnNet 32, Novell's
     Protected-mode client (which is MUCH more secure than Microsoft
     Client for Netware).

  �  It cannot be used with the Microsoft Network client over TCP/IP,
     since Microsoft provides no real-mode driver for TCP/IP compatibe
     with Windows 95. That means, it cannot be used with Samba

  �  It makes software upgrades almost impossible since every client
     turned on will lock many DLLs on the server, and thus produce
     sharing violations if you try to upgrade them.

     Consequently, we throwed away of this document all the informations
     and bug-workaround collected during months (you can still find them
     as a HTML document at http://cuiwww.unige.ch/info/pc/remote-
     boot/win95old/win95old.html) and turned to our new disk-based
     remote-boot concept.  Basically, the configuration for Windows 95
     is now almost as easy the configuration for DOS.

  3.4.1.  Setting up a Stand-Alone Client

  Boot the client computer in DOS, either using the Boot menu if you
  have already setup the DOS/Windows 3.1 configuration, or using a
  floppy disk (aborting the BootPROM by pressing space).  The advantage
  of the first solution is that you will then have a running network
  client, and that you probably already have somewhere on your server
  the distribution disks for Windows 95.

  If you boot from a floppy disk, you will probably first need to format
  the dos partition of your hard-drive with the /S option, in order to
  put the operating system on it.  If you boot using a DOS/Windows 3.1
  configuration start by removing files that you don't need for Windows
  95 setup and that you do not want to be in your final boot image (for
  instance, the WINDOWS directory).

  Start Windows 95 setup, and follow all steps of a local install.  At
  the end of the install, setup will reboot your computer, make some
  settings and reboot again. For all these reboot, choose the Boot from
  local hard-disk option of your boot menu.  Once you have set up all
  drivers you want, you shall consider running defrag and doing a full
  defragmentation (including defragmenting free space).

  You should also consider recovering the memory used by the BootPROM by
  inserting the following line at the beginning of your config.sys:

       ______________________________________________________________________
       device=\util\bputil.sys -r
       ______________________________________________________________________

  (bputil is a program provided on the TCP/IP Bootprom utility disk).
  In opposition to DOS, you shall better avoid to use EMM386 with Win�
  dows 95.
  If you want to reduce network and server load (which will improve your
  system performances) while keeping all softwares on the server, you
  should consider installing the excellent Shared LAN Cache, from
  Measurement Techniques, Inc (see http://www.lancache.com).  This
  software runs on each client computer, and caches to the local hard
  disk every data obtained from the network. Even MS-Office starts much
  faster the second time you run it... You need one license per client
  computer, but it is not very expensive, and the firm make special
  prices for universities and colleges. The best thing to do is to go to
  their Web site and download the free evaluation copy.

  3.4.2.  Moving the Configuration to the Server

  On the server, if you don't already have it, make a share called admin
  for instance, on which you will put some stuff for the system
  administrator.  If the server is a Unix machine, it is a good
  opportunity to put in admin a softlink to the /tftpboot subdirectory,
  so that you can put images in it directly from the client.  Within
  admin, create a /utils subdirectory and put the following utilities in
  it:

  �  mrzip.exe, a program that will create a compressed image of your
     hard disk.

  �  mrunzip.exe, a program that can restore from within DOS a
     compressed image of your hard disk.

  Open a MS-DOS window on your client, mount the admin volume on drive
  L: for instance and execute the following command (absolute path names
  are not required, but they do not hurt :-)

       ______________________________________________________________________
               L:\util\mrzip L:\tftpboot\win95
       ______________________________________________________________________

  This will create two new files in the /tftpboot subdirectory of your
  server, namely win95.imz, the compressed image of your hard disk and
  win95.chk, the associated checksum file (which is in fact a slightly
  modified copy of the partition boot record).  In this very directory,
  just create a symbolic link to (or a copy of) bpunzip named win95.P.

  Your disk-based remote-boot configuration of Windows 95 is now ready.

  3.4.3.  Testing the Remote-Boot Client

  Now reboot your client and choose the Windows 95 option of the boot
  menu. The bpunzip program shall give you some message about his
  updating the image table, and then download the whole boot image from
  the network (since it is the first time that it sees this boot image).
  This will take about two minutes.  Then it will uncompress the image
  to the DOS partition, and boot it. Here you are, your remote-boot
  client is ready !  Next time you reboot it, it will only uncompress
  the image, probably in about 40 seconds.

  3.4.4.  Adapting the configuration for other Machines

  The big difference between Windows 3.1 and Windows 95 is that the
  later includes code for Plug-and-play , ie. automatic detection of
  your hardware. This not a bad thing in itself, but the trouble is that
  it is often too sensible, and that it sometimes fails.

  If you try to start another client with exactly the same boot image,
  you will probably get several messages during startup telling that
  Windows has detected new hardware: a new sound card, a new hard-disk,
  a new network card, and even a new mouse... There can be two reasons
  for that:

  �  the devices may not use the same ressources (for instance the mouse
     is not connected on the same port, or the sound card is not
     connected in the same slot - yes, that is detected)

  �  the devices may tell to Windows 95 their personal serial number
     (for instance, every Windows 95 differenciate every network card on
     the basis of its world-wide unique ethernet address)

     The fact that Windows 95 discover that the hardware has changed may
     not be a problem if the plug-and-play works as-is, but it become a
     problem when the plug-and-play does not work. For instance, Windows
     95 plug-and-play for our Logitech PS2/aux mouse does not work, and
     result in no mouse at all. To solve such kind of problems, arrange
     to have all computers as similar as possible.

  The thing you cannot avoid to differ between computers is the network
  card. Bad luck for us, the plug-and-play code for our SMC EtherEZ card
  hangs the computer. The only solution is to let Windows 95 believe
  that it already know the network card, and that it is not necessary to
  trigger plug-and-play. The trick for doing that is to automatically
  insert an entry for the network card in Windows 95 registery, from the
  autoexec.bat.  Note that this trick is not any more needed with most
  PCI cards.

  On your client computer, edit the autoexec.bat and add the following
  lines:

       ______________________________________________________________________
       rem --- Patch Windows registery in order to avoid plug-and-play detection
       cls
       unzipreg c:\lib\smc.reg c:\temp\smc.reg
       regedit /L:c:\win95\system.dat /R:c:\win95\user.dat c:\temp\smc.reg
       echo.
       del c:\temp\smc.reg
       ______________________________________________________________________

  regedit is a standard Windows 95 program that let you browse the reg�
  istery if you start it from within Windows 95, or do simple operations
  on the registery if you call it from DOS.  unzipreg.exe is a small
  home-made program that you should put somewhere in your path.  It will
  read a special hidden file created by bpunzip, namely BOOTP.ANS, that
  contains the original BOOTP/DHCP reply sent by the server. Then, it
  will read the file given as first argument, substitute all strings of
  the form UNZIPREG:tagname: by their content in the BOOTP/DHCP reply
  and write the result on the file given as second argument.

  In in the lib subdirectory, we have a file named smc.reg with the
  following content:

  ______________________________________________________________________
  REGEDIT4

  [HKEY_LOCAL_MACHINE\Enum\ISAPNP\SMC8416\UNZIPREG:MACID:C0]
  "HardwareID"="*SMC8416,ISAPNP\SMC8416"
  "HWRevision"="1.0.10"
  "DeviceDesc"="SMC EtherEZ (8416)"
  "Class"="Net"
  "Driver"="Net\\0001"
  "CompatibleIDs"="*SMC8416"
  "Mfg"="SMC"
  "ConfigFlags"=hex:10,00,00,00

  [HKEY_LOCAL_MACHINE\Enum\ISAPNP\SMC8416\UNZIPREG:MACID:C0\Bindings]
  "MSTCP\\0001"=""

  [HKEY_LOCAL_MACHINE\Enum\ISAPNP\SMC8416\UNZIPREG:MACID:C0\LogConfig]
  "0000"=hex:00,04,00,00,00,20,00,00,10,00,00,00,04,00,00,00,00,00,00,00,a8,0e,\
    00,00,20,00,00,00,02,00,00,00,01,00,0c,00,00,00,00,00,00,00,00,00,e0,ff,20,\
    00,40,02,ff,03,00,00,04,03,2c,00,00,00,01,00,00,00,01,00,14,00,00,00,00,00,\
    00,00,00,00,00,00,00,00,00,e0,ff,ff,00,20,00,00,00,00,0c,00,ff,ff,0f,00,00,\
    00,00,00,2c,00,00,00,01,80,00,00,01,00,14,00,00,00,00,00,00,00,00,00,00,00,\
    00,00,00,e0,ff,ff,00,80,00,00,00,00,0c,00,ff,5f,10,00,00,00,00,00,00,00,00,\
    00

  [HKEY_LOCAL_MACHINE\Enum\ISAPNP\SMC8416\UNZIPREG:MACID:C1]
  "HardwareID"="*SMC8416,ISAPNP\SMC8416"
  "HWRevision"="1.0.10"
  "DeviceDesc"="SMC EtherEZ (8416)"
  "Class"="Net"
  "Driver"="Net\\0001"
  "CompatibleIDs"="*SMC8416"
  "Mfg"="SMC"
  "ConfigFlags"=hex:10,00,00,00

  [HKEY_LOCAL_MACHINE\Enum\ISAPNP\SMC8416\UNZIPREG:MACID:C1\Bindings]
  "MSTCP\\0001"=""

  [HKEY_LOCAL_MACHINE\Enum\ISAPNP\SMC8416\UNZIPREG:MACID:C1\LogConfig]
  "0000"=hex:00,04,00,00,00,20,00,00,10,00,00,00,04,00,00,00,00,00,00,00,a8,0e,\
    00,00,20,00,00,00,02,00,00,00,01,00,0c,00,00,00,00,00,00,00,00,00,e0,ff,20,\
    00,40,02,ff,03,00,00,04,03,2c,00,00,00,01,00,00,00,01,00,14,00,00,00,00,00,\
    00,00,00,00,00,00,00,00,00,e0,ff,ff,00,20,00,00,00,00,0c,00,ff,ff,0f,00,00,\
    00,00,00,2c,00,00,00,01,80,00,00,01,00,14,00,00,00,00,00,00,00,00,00,00,00,\
    00,00,00,e0,ff,ff,00,80,00,00,00,00,0c,00,ff,5f,10,00,00,00,00,00,00,00,00,\
    00
  ______________________________________________________________________

  This file was initially generated using the Windows 95 interface to
  regedit. We exported the branch corresponding to our network adapter
  (HKEY_LOCAL_MACHINE/Enum/ISAPNP/SMC8416) and substituted the number
  corresponding to the adapter hardware address by the tag
  UNZIPREG:MACID:. When we run unzipreg on this file, it will automati�
  cally substitute the tag by the number corresponding to the actual
  netword adapter. Note that there is one number after the MACID that
  was sometimes C0, sometimes C1. Since it does not hurt to put a non-
  existant adapter in the registery, we add entries for both.

  Once again, this whole trick is not necessary when using PCI network
  adapters.  Incidentally, we can use the same mechanism for
  automatically configuring the hostname, which Windows 95 does not seem
  to take into account when configuring through DHCP. We just add the
  following line to our smc.reg file:
       ______________________________________________________________________
       [HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\VNETSUP]
       "ComputerName"="UNZIPREG:HOSTNAME:"

       [HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\MSTCP]
       "HostName"="UNZIPREG:HOSTNAME:"

       [HKEY_LOCAL_MACHINE\System\CurrentControlSet\control\ComputerName\ComputerName]
       "ComputerName"="UNZIPREG:HOSTNAME:"
       ______________________________________________________________________

  You can also use the same mechanism to customize other settings
  according to the machine type or to its location. For examples of
  that, see also the corresponding paragraph of the DOS/Windows 3.1
  configuration description.

  After making any change to the client machine configuration, do not
  forget to rebuild the disk image using mrzip, or all your changes will
  be lost.

  Using this small registery trick, your configuration should normally
  be portable for all machines with similar configurations. If you
  cannot avoid that Windows detect some hardware as new on one machine,
  try to rebuild the disk image from this machine. This will include the
  registery configuration specific to this machine into the image, and
  hopefully supress the problem.

  As the disk image decompression may take some time (typically 20-30
  sec.), you may want to give to the user informations or just a nice
  picture to look at.  This can be done very easily (see the
  documentation on BPUNZIP below).

  If you are interested in getting more informations and tools for
  configuring Samba with remote boot computers, we have written another
  document. Have a look at http://cuiwww.unige.ch/info/pc.

  4.  TCP/IP Bootprom Related Utilities

  This section gives some informations on the use of the utilities we
  wrote for use with the TCP/IP Bootprom.

  4.1.  MENUEDIT

  This is a program running under DOS, for editing menu scripts usable
  with the TCP/IP Bootprom. It is very basic, but is still much more
  comfortable to use than the menu scripts themselves. You can get
  online-help by depressing the F1 key. If you want to enhance it (for
  instancing adding cut-and-paste), I would be happy to publish your new
  version.

  Pascal source code is available here.

  4.2.  BPHDBOOT

  This boot image will load the hard-disk master boot record and jump
  into it.

  This boot image is particularly convenient to use when configuring an
  operating system that wants you to reboot before it finalizes its
  configuration. It can also be used on computers for which you do not
  want to impose a hard-disk cleanup at any time but you still want to
  be able to do it whenever needed.

  Assembler source code is available here.

  4.3.  BPCLEAN

  This boot image rewrite the hard-disk master boot record, including
  the hard-disk partition table. Moreover, it can quick-format a DOS
  (FAT16) data partition (but cannot make it bootable).  For copyright
  reasons, we had to program our own master boot record and FAT16 boot
  sector. They should behave more or less like the standard
  implementation, except that some messages have been adapted for the
  context of remote-boot computers. In order to have this program work,
  you might need to disable the BIOS master boot record protection
  (which is anyway not any more necessary since it will be refreshed at
  each boot).

  This program downloads the partition table description file with the
  same basename as itself and the .tab extension. This file can contains
  empty lines, comments beginning with a sharp but should never exceed
  512 characters.

  The first four non-blank non-commented lines should contain the
  discription for the four hard disk partitions. The fifth non-blank
  non-commented line should contain the name of the next boot image to
  load.

  Partition description lines are made of several space- or tab-
  separated fields, and must be in one of the following three forms:

       ______________________________________________________________________
       type  boot?  1st-cyl  1st-head  1st-sect  last-cyl  last-head  last-sect
       type  boot?  1st-cyl  1st-head  1st-sect  relative-size
       type  boot?  relative-size
       ______________________________________________________________________

  �  In the first form, the file give the precise geometry of the
     partition.

  �  In the second form, the first sector position is given but the end
     of the partition is automatically calculated on the basis of the
     requested partition size.

  �  In the third form, the first sector is automatically deduced from
     the end of the previous partition and the end of the partition is
     automatically calculated on the basis of the requested partition
     size. This form is totally independant of the hard-disk geometry.

     Every number is assumed to be in decimal form, except when prefixed
     with a dollard, in which case it is assumed to be an hexadecimal
     number.

  �  The type of a partition is 4 for DOS partitions under 32Mb, and 6
     for DOS partitions from 32Mb to 500Mb.  Many other values can be
     found using Linux fdisk help for instance.

  �  The boot? field should be Y for the boot partition and N for all
     other partitions. This flag is used by the master boot record.

  �  The 1st-cyl, 1st-head and 1st-sect are the absolute coordinates of
     the first sector of the partition. Do not forget that while
     cylinders and heads are numbered starting from 0, sectors are
     numbered starting from 1.

  �  The last-cyl, last-head and last-sect are the absolute coordinates
     of the last sector of the partition. Partition usually end on a
     cylinder boundary.

  �  The relative-size of a partition takes can be expressed in the
     following ways:

  �  + 10 Mb which means that the partition should be at least 10 Mb
     (ie. 2048 sectors) big;

  �  - 100 Mb which means that the partition should leave at least 100
     Mb (ie. 20480 sectors) free for the next partitions;

  �  + 30 % which means that the partition should occupy at least 30
     percent of the space available at this point;

  �  - 70 % which means that the partition shouls leave at least 70
     percent of the space available at this point for the next
     partitions.

     Partitions defined by their relative size always end on a cylinder
     boundary, and unless the first sector position is precised, start
     after a head boundary. To our knowledge, this is conform to the
     standard usage.

  Whenever a label is appended at the end of a partition description
  line, the corresponding partition is formatted as a DOS FAT16
  partition, whatever its type. This is compatible both with partition
  types 4 and 6, and is particularely usefull for cleaning a DOS
  partition on a student computer for instance. Such quick-format only
  takes some tenths of a second.

  By default, bpclean is compiled with support for LBA (no more than
  1024 cylinders, and up to 256 heads). Some strange BIOSes and some
  strange OSes prefer the so-called NORMAL mode (up to 4096 cylinders,
  but no more than 64 heads); if you need it, comment the LBA definition
  in the source code and recompile it.

  Assembler source code is available here.

  4.4.  MRZIP, MRUNZIP and BPUNZIP

  MrZip is a DOS program that can build a compressed raw image of a DOS
  FAT16 partition. It first analyses the disk usage in order to process
  only used data bytes, and then uses a very fast (but not very
  efficient) statistical compression algorithm to compress the data.
  Windows 95 long filenames are supported, and files with the .SWP
  extension are not saved. Several magic numbers are included between
  the various parts of the archive, and a checksum is computed on the
  original data. The checksum is stored as the low-order word of the
  volume serial number in the archive, while the high-order word is
  simply incremented.  If you zero the serial number of your hard-disk
  before building the compressed image, you can then use this number to
  track the number of updates to your image.

  Since MrZip uses direct disk access, it recommended that you flush any
  disk write cache before you run it. Windows 95 seems to handle direct
  disk access consistently.

  MrUnzip is a DOS program that can expand a compressed disk image to
  the hard-disk, using direct disk access. Do not use it in conjunction
  with any cache program, as it is already sufficiently afflicting for
  the DOS itself... Anyway, it can be very helpfull if you you want to
  fix a boot image that cannot boot anymore for instance.

  BpUnzip is a boot image that manage compressed hard disk images.
  Roughly, it will boot from the hard disk image with the same base
  name, with the extension .imz.

  It first read the partition table and look for

  �  the first DOS partition, where the disk image should be restored

  �  the last cylinder allocated for a partition, after which the
     compressed hard disk images will be stored.

     It then read the first sector of the first unused cylinder and see
     if there is already an image table. If it is not the case, or if
     the image table contains some inconsistency, or if both shift keys
     are depressed (a special general-cleaning signal), the image table
     is cleared.

  If the image table does not already contains the requested image, it
  is loaded using TFTP and added to the image table. If there is not
  enough space after previously loaded images for the new one, old
  images are discarded. If the image was already present in the image
  table, the most recent image boot sector (including the checksum) is
  loaded by TFTP and compared against the available image. If they are
  not exactly the same, the compressed image is reloaded.

  The image is then uncompressed, all magic numbers are verified, and
  the checksum is computed on the decompressed data. If the
  decompression fails, or if the checksum does not match the value
  included in the most recent boot sector, the image is assumed to be
  corrupted and is reloaded. Otherwise, the program gives the control to
  the boot sector, and the operating system is started.

  If bpunzip was loaded with a .P extension (for instance as win95.P),
  it is assumed that the TFTP server has an extended interface on port
  59 (in addition to the regular interface on port 69).  BpUnzip will
  then use it for loading the image using bigger packets, typically 1408
  bytes instead of 512 bytes per packet (this convention for using
  triggering the use of big packets is very similar to that used by the
  TCP/IP Bootprom).

  Similarly, if bpunzip was loaded with a .G extension (for instance as
  win95.GP), it will first download a GIF file with the same basename
  (for instance win95.gif) and display it on the screen during the whole
  operation. The program works only in 800x600, 256 color mode (although
  the GIF file can be smaller and use less colors). If your video
  adapter is not VESA compatible, this feature is not available to you.
  Note than the last 16 colors of the palette are used to display the
  progress bar banner. Either do not use them, or expect them to be
  incorrect. By the way, if you don't like our progress bar banner, feel
  free to change it (in GIFDATA.ASM), but please leave our names visible
  somewhere.

  The target partition does not have to be exactly of the same size as
  the original one; it just have to be big enough to hold the clusters
  from the beginning of the partition to the last used cluster.  If the
  destination partition is smaller than the original partition, the FAT
  will be shrinked accordingly (but not the cluster size).  If the the
  destination partition is bigger than the original partition, the FAT
  will be expanded as much as possible. However, if the destination
  partition is much bigger than the original, it is likely that 65518
  clusters will not be enough to cover all space (since the cluster size
  cannot be adapted). In this case, bpunzip will issue a warning telling
  that some space is lost.

  By default, bpunzip is compiled with support for LBA (no more than
  1024 cylinders, and up to 256 heads). Some strange BIOSes and some
  strange OSes prefer the so-called NORMAL mode (up to 4096 cylinders,
  but no more than 64 heads); if you need it, comment the LBA definition
  in the source code and recompile it.

  Assembler source code is available here.

  You might encounter problems with Solaris 2.5 TFTP server when dealing
  with images bigger than 16 Megabytes. This is because it cannot handle
  more than 32768 packets per file.  This is a known bug, for which SUN
  currently provides no fix.  We suggest using the more efficient
  extended TFTP server (also provided for other OS on your TCP/IP
  Bootprom utility disk).

  4.5.  NOBREAK

  Nobreak.sys is a very small (about 350 bytes only) driver that you
  include at the beginning of your config.sys. Its goal is to secure the
  boot process, until the user is logged in.  DOS provides a setting for
  this (namely BREAK=OFF), but it is not drastic enough, and has almost
  no effect in the autoexec.bat.  Our driver works by modifying the
  scan-code of the key pressed when a break is requested, directly at
  the BIOS level.  This way, no program at all can receive a break until
  break is enabled again.

  The driver must be loaded from the config.sys (or using the devlod
  program from Undocumented DOS). Afterwards, break can be enabled by
  sending Yes to the NOBRK pseudo-device, and disabled again by sending
  No (in fact, only the first character, Y or N is significant).

  As this driver relies on the BIOS, it does only work for DOS and
  Windows 3.1.  Windows 95 has its own low-level keyboard handling
  routines.

  Assembler source code is available here.

  5.  Discussion

  We here discuss some theoretical issues related to our configuration.

  5.1.  Bootproms and Hard Disks

  Bootproms exist for quite a long time, but they are usually used for
  diskless computers only. In our opinion, bootproms are even more
  interesting for computers which have a local harddisk, since they
  allow to take profit of both sides:

  �  A bootprom make the configurations more robust, since it ensure
     that the computer will always boot the same way, no matter any
     virus or partition table crash. It can be used, as we did, to
     cleanup the harddisk even before the operating system is loaded.

  �  A local harddisk make the configuration more efficient, since it
     can reduce the network trafic through caching, and allows for
     efficient swap.

  5.2.  Which Bootprom ?

  Several bootproms are available for PCs. We had several reason for
  choosing the TCP/IP Bootprom from K�ppen EDV GmbH:

  �  It is based on the BOOTP/DHCP protocol, which is publicly defined
     by RFCs.  The definition states that when a BOOTP/DHCP server
     receives a request from a client that he doesn't know, the server
     will not answer.  This avoids interferences between multiple
     servers, as you might sadly experience with the MSD boot server.
     Moreover, since IP broadcasts are confined to the local subnet,
     they produce less noise than their IPX counterpart.

  �  It is not bound to a specific operating system.

  �  Technical informations and API informations are available on
     request.

  �  Home-made boot loader can be written (as we have done)

  �  The boot process can be parametrized on many ways. Specifically, it
     allowed us to forestall floppy boot on old-fashioned AST computers,
     which BIOS did not include this feature.

  �  Tools are provided for building and maintaining boot menus.