7cff104cce6199ca3645d26ee7a2f058b8961d8a
[collab-maint/debian-lan.git] / debian / README.Debian
1 The Debian package debian-lan-config
2 ====================================
3
4 This package contains the FAI config space for the Debian-LAN system.
5 Details about Debian-LAN and verbose instructions are available in the
6 Debian wiki at <URL:http://wiki.debian.org/DebianLAN>.
7
8 There are two ways available to install the Debian-LAN mainserver:
9
10   - prepare a CD image and install from that image
11 or
12   - install a minimal Debian and convert that installation
13
14 Choose the method appropriate for your situation.
15
16
17 Creating a CD image with fai-cd
18 -------------------------------
19
20 Create the CD image in the following way:
21
22    apt-get install aptitude  # needed for FAI
23    aptitude install debian-lan-config  # might be already installed
24    aptitude -R install fai-server xorriso # no recommends needed
25    mkdir /srv/fai/
26    cp -r /usr/share/debian-lan-config/fai/config /srv/fai/
27    cp -b /srv/fai/config/files/etc/fai/grub.cfg/SERVER_A /etc/fai/grub.cfg
28    cp -b /srv/fai/config/files/etc/fai/NFSROOT/FAISERVER /etc/fai/NFSROOT
29    cp -b /srv/fai/config/files/etc/fai/nfsroot.conf/SERVER_A /etc/fai/nfsroot.conf
30    cp -b /srv/fai/config/files/etc/fai/apt/sources.list/SERVER_A /etc/fai/apt/sources.list
31
32 Use live-boot for the fai-cd:
33
34     sed -i -r -e "s/^(dracut.*$)/\#\1/" /etc/fai/NFSROOT
35     sed -i -r -e "s/^\#(live-boot.*)/\1/" /etc/fai/NFSROOT
36
37 Adapt the config space to your needs if necessary and create the FAI
38 nfsroot:
39
40    fai-make-nfsroot -v -l
41
42 The CD image is then created by fai-cd:
43
44    fai-cd -M fai-cd.iso
45
46
47 Converting a minimal Debian installation
48 ----------------------------------------
49
50 Install a minimal Debian (only the core system) on the server.  Choose
51 'mainserver' as hostname.  Prepare appropriate partitions, examples
52 are available in /usr/share/debian-lan-config/fai/config/disk_config/.
53
54 Then convert the installation with the following commands:
55
56    apt-get install aptitude  # needed for FAI
57    aptitude install debian-lan-config  # might be already installed
58    aptitude -R install fai-server dialog  # no recommends needed
59    mkdir /srv/fai/
60    cp -r /usr/share/debian-lan-config/fai/config /srv/fai/
61
62 Adapt the config space to your needs if necessary and run FAI with the
63 variable CONVERT set to true:
64
65    export CONVERT=true ; fai -vN -s file:///srv/fai/config/ softupdate
66
67  -- Andreas B. Mundt <andi@debian.org>  Wed, 30 Jan 2013 18:50:03 +0100