http://www.phys.ethz.ch/~franklin/Projects/dphys2/INSTALL
copyright ETH Zuerich Physics Deparement, use under either BSD or GPL license
author Neil Franklin, last modification 2002.12.18

At the moment this project has just reached the 1st milestone.


To use/install dphys2 do the following:


1. *HARDWARE* Get yourself 2 formatted but empty floppy disks (only 1 needed
   if you already have an Debian rescue disk)


2. Download and unpack the distribution archive file into any directory from:

   http://www.phys.ethz.ch/~franklin/Projects/dphys2/dphys2.tar.gz

   I use these commands for this:

     wget http://www.phys.ethz.ch/~franklin/Projects/dphys2/dphys2.tar.gz
     tar zxpf dphys2.tar.gz
     cd dphys2


3. *PERMISSIONS* Switch to being  root  which is needed for generating the
   disk images


4. In the  dphys2  directory edit the configuration file:  setup-dphys2

   Tell dphys2 about your site/subnet specific details (the rest should
   default to sensible stuff):

   - what work directory to use for processing root floppy (PREFIX, WORKDIR)
     Note1: this directory must be root writable (not an root-squash NFS mount)
     Note2: this must be on a filesystem with about 50MB free space

   - which Debian mirror you are using (CONF_DEBSERVER)
     and the base path on that mirror (CONF_DEBDIR)

   - what network card drivers you want to include (MODULESNET)

   - what HD to install on (CONF_DISK)

   - layout of keyboard, file relative to /usr/share/keymaps/ (CONF_KEYBD)

   - domain specific network setup, domain name (CONF_DOMAIN) and DNS servers
     (CONF_NAMESERVER1 to CONF_NAMESERVER4)

   - subnet specific network setup (CONF_NETMASK, CONF_NETWORK,
     CONF_GATEWAY, CONF_BROADCAST)

   - desired passwords (CONF_PASSWORD_LILO, CONF_PASSWORD_ROOT)

   - yout time zone info (CONF_TIMEZOME_AREA, CONF_TIMEZOME_PLACE)

   - your Debian mirror(s) for non-US, security and local packages
     (CONF_DEBSERVER_NON_US, CONF_DEBDIR_NON_US, CONF_DEBSERVER_SECURITY
      CONF_DEBDIR_SECURITY, CONF_DEBSERVER_LOCAL, CONF_DEBDIR_LOCAL)


5. *SECURITY* Ensure that the  dphys2-setup  file is protected and remains so.
   Else you will compromise your LILO and root passwords:

   chmod 600 dphys2-setup


6. Create the  modified root  floppy image by typing:

   make                          # this must run as root, else permissions lost


7. Get the first floppy and install the  modified root  image to it with:

   make install


8. *GOTCHA* You will need to repeat steps "edit" to "make install" for each
   subnet, to generate an different floppy for each subnet. Write on each
   floppy which is for which subnet.


9. If you have not already got an standard(!) Debian  rescue  floppy you can
   simply make one on the second floppy with:

   make rescue                   # download rescue image
   make installrescue            # write rescue image to 2nd / rescue floppy


10. *FACULTATIVE*:  Clean up work directory, and reclaim your 50MBytes with:

    make clean


11. *TARGET* Go to your target system, and boot it from the  rescue  floppy,
    and wait for it to demand an  root  floppy.


12. Insert the  modified root  floppy, press enter, and wait for it to be
    read in, and the  dphys2  banner to be displayed.


13. Eject the  root  floppy, so that the host can auto-boot from HD later on.


14. Enter your desired  hostname.


15. Enter your desired  IP address.


16. *AUTOMATIC* At end of 1st stage install (in a few minutes time), the host
    will automatically reboot into 2nd stage of install and continue with that,
    until it is finished (in about 10 minutes time).


17. You can now log in with  root  and your password (there is no normal user),
    and have an fully installed Debian woody base system in front of you. Have
    fun with apt-get.


Thats all folks!