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