The Debian package debian-lan-config
====================================

This package contains the FAI config space for the Debian-LAN system.
Details about Debian-LAN and verbose instructions are available in the
Debian wiki at <URL:http://wiki.debian.org/DebianLAN>.

There are two ways available to install the Debian-LAN mainserver:

  - prepare a CD image and install from that image
or
  - install a minimal Debian and convert that installation

Choose the method appropriate for your situation.


Creating a CD image with fai-cd
-------------------------------

Create the CD image in the following way:

   apt-get install aptitude  # needed for FAI
   aptitude install debian-lan-config  # might be already installed
   aptitude -R install fai-server xorriso # no recommends needed
   mkdir /srv/fai/
   cp -r /usr/share/debian-lan-config/fai/config /srv/fai/
   cp -b /srv/fai/config/files/etc/fai/grub.cfg/SERVER_A /etc/fai/grub.cfg
   cp -b /srv/fai/config/files/etc/fai/NFSROOT/FAISERVER /etc/fai/NFSROOT
   cp -b /srv/fai/config/files/etc/fai/nfsroot.conf/SERVER_A /etc/fai/nfsroot.conf
   cp -b /srv/fai/config/files/etc/fai/apt/sources.list/SERVER_A /etc/fai/apt/sources.list

Use live-boot for the fai-cd:

    sed -i -r -e "s/^(dracut.*$)/\#\1/" /etc/fai/NFSROOT
    sed -i -r -e "s/^\#(live-boot.*)/\1/" /etc/fai/NFSROOT

Adapt the config space to your needs if necessary and create the FAI
nfsroot:

   fai-make-nfsroot -v -l

The CD image is then created by fai-cd:

   fai-cd -M fai-cd.iso


Converting a minimal Debian installation
----------------------------------------

Install a minimal Debian (only the core system) on the server.  Choose
'mainserver' as hostname.  Prepare appropriate partitions, examples
are available in /usr/share/debian-lan-config/fai/config/disk_config/.

Then convert the installation with the following commands:

   apt-get install aptitude  # needed for FAI
   aptitude install debian-lan-config  # might be already installed
   aptitude -R install fai-server dialog  # no recommends needed
   mkdir /srv/fai/
   cp -r /usr/share/debian-lan-config/fai/config /srv/fai/

Adapt the config space to your needs if necessary and run FAI with the
variable CONVERT set to true:

   export SUDO_FORCE_REMOVE=yes  # to switch from sudo to sudo-ldap
   export CONVERT=true ; fai -vN -s file:///srv/fai/config/ softupdate


Further Notes
-------------

If you prefer not to use the hostname 'mainserver' but $HOSTNAME, use
the following commands to replace it in the fai config space:

   cd /srv/fai/config/
   for FILE in $(grep -rl mainserver *) ; \
       do sed -i "s/mainserver/$HOSTNAME/g" $FILE ; done

   mv files/etc/hosts/mainserver files/etc/hosts/$HOSTNAME
   cd -

 -- Andreas B. Mundt <andi@debian.org>  Tue, 31 Mar 2015 22:50:03 +0200
