92a4d7df26c0ca56f36e21b94d9f7db245816ba4
[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    aptitude install debian-lan-config  # might be already installed
23    aptitude -R install fai-server xorriso # no recommends needed
24    mkdir /srv/fai/
25    cp -r /usr/share/debian-lan-config/fai/config /srv/fai/
26    cp -b /srv/fai/config/files/etc/fai/grub.cfg/SERVER_A /etc/fai/grub.cfg
27    cp -b /srv/fai/config/files/etc/fai/NFSROOT/FAISERVER /etc/fai/NFSROOT
28    cp -b /srv/fai/config/files/etc/fai/nfsroot.conf/SERVER_A /etc/fai/nfsroot.conf
29    cp -b /srv/fai/config/files/etc/fai/apt/sources.list/SERVER_A /etc/fai/apt/sources.list
30
31 Use live-boot for the fai-cd:
32
33     sed -i -r -e "s/^(dracut.*$)/\#\1/" /etc/fai/NFSROOT
34     sed -i -r -e "s/^\#live-boot.*/live-boot/" /etc/fai/NFSROOT
35
36 Adapt the config space to your needs if necessary and create the FAI
37 nfsroot:
38
39    fai-make-nfsroot -v -l
40
41 The CD image is then created by fai-cd:
42
43    fai-cd -M fai-cd.iso
44
45
46 Converting a minimal Debian installation
47 ----------------------------------------
48
49 Install a minimal Debian (only the core system) on the server.  Choose
50 'mainserver' as hostname.  Prepare appropriate partitions, examples
51 are available in /usr/share/debian-lan-config/fai/config/disk_config/.
52
53 Then convert the installation with the following commands:
54
55    aptitude install debian-lan-config  # might be already installed
56    aptitude -R install fai-server dialog  # no recommends needed
57    mkdir /srv/fai/
58    cp -r /usr/share/debian-lan-config/fai/config /srv/fai/
59
60 Adapt the config space to your needs if necessary and run FAI with the
61 variable CONVERT set to true:
62
63    export CONVERT=true ; fai -vN -s file:///srv/fai/config/ softupdate
64
65  -- Andreas B. Mundt <andi@debian.org>  Wed, 30 Jan 2013 18:50:03 +0100