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 2003.04.10

To install/config/use dphys2 do the following:


Install
=======

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

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

   I presently use this command sequence for this:

     cd /usr/local/tar
     rm -f dphys2.tar.gz

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

     cd /usr/local/src
     rm -rf dphys2

     tar zxpf ../tar/dphys2.tar.gz
     cd dphys2


Configuration
=============

2. *PERMISSIONS* Switch to being  root  which is needed for generating the
   disk images, else they will have screwed up file owners


3. 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
     (CONF_PREFIX, CONF_DPHYS2, CONF_WORKDIR)
     Note1: this directory must be root writable (not an root-squash NFS mount)
     Note2: this must be on a filesystem with at least 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 (CONF_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)
     [comment out not wanted ones]

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

   - desired passwords (CONF_PASSWORD_LILO, CONF_PASSWORD_ROOT)

   - your time zone info (CONF_TIMEZOME_AREA, CONF_TIMEZOME_PLACE)

   - your preference on what packages to use
     (CONF_USE_CONTRIB, CONF_USE_NON_FREE, CONF_USE_PROPOSED)

   - 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)


4. If you want to automagically run an user script (or binary) at the end of
   the first install stage (or indirectly have this install/run stuff in 2nd
   stage):

   - uncomment and possibly set the filename (CONF_ENDFIRSTRUN_SCRIPT)

   See the sample  endfirstrun  script for what can be done here.


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

   chmod 600 dphys2-setup


6. Create the  modified root floppy image  by typing:

   make                 # this must run as user root, else permissions are lost


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


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

   make install


9. *GOTCHA* You will need to repeat steps "edit" to "make install" for each
   subnet, to generate an different floppy for each subnet.

   So this requires n+1 floppies if you have n subnets. Or n floppies if you
   already have an Debian rescue disk.

   Write on each floppy which is for which subnet. Confusing them costs an
   re-install and such time loss is annoying :-).


10. If you have not already got an standard(!) Debian  rescue  floppy you can
    simply make one on the second (or n+1th) floppy with:

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


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

    make clean


Using
=====

12. *TARGET* Go to your target system, and boot it from the  rescue  floppy,
    load the kernel without any options, and wait for it to demand an  root
    floppy.


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


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


15. Enter your desired  hostname.


16. Enter your desired  IP address.


17. *AUTOMATIC* At end of first 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 a few more minutes time).


18. 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.

19. Only the steps "target" to "login" need to be repeated for each host. This
    is why hostname and IP address are typed in, to not have to repeat all the
    floppy generating stuff before.


Thats all folks!