Quelltext der Seite Fai-etch

= Anmerkung =
<b>Vorgabe ist, eine vollautomatisierte Debian Linux Client-Installation mit<br>
unterschiedlicher Soft- und Hardwareausstattung der Clients.

<u>Die Lösung wird mit einem Fai-Server umgesetzt.</u></b>

= Version und Voraussetzungen =
<b>Linux :  Debian Etche <br>
</b>Grundinstallation linux26 <br><b>
Fai   :<br></b>
 '''fai-client'''              3.1.8         Fully Automatic Installation client package
 '''fai-doc'''                 3.1.8         Documentation for FAI
 '''fai-kernels'''             1.17+b1       special kernels for FAI (Fully Automatic Ins
 '''fai-quickstart'''          3.1.8         Fully Automatic Installation quickstart pack
 '''fai-server'''              3.1.8         Fully Automatic Installation server package

= BUG =
= Fai-Server (Fully Automatic Installation) =
<b>Fai ist ein Installationsserver für Automatisierte Linux-Installation.</b> <br>
In diesem Artikel wird die Installation des Fai-Servers und den benötigten Diensten erklärt.<br>
Homepage von [[http://www.informatik.uni-koeln.de/fai/  Fai ]]<br> 
Wiki von [[http://faiwiki.informatik.uni-koeln.de/index.php/Main_Page  Fai ]]<br>
== Debian-Pakete installieren ==
* Etch bringt die Fai-Pakete mit.
* Nach eienem Eintrag in der <B>"source.list"</B> des Debianservers können auch aktuelle Debian-Pakete des Faiservers
mit <b>"aptitude"</b> installiert werden.
 # vi /etc/apt/source.list
   
 <nowiki>deb http://www.informatik.uni-koeln.de/fai/download sarge koeln</nowiki>

==== Fai ====
 # aptitude update
 # aptitude install fai-quickstart
Dabei werden folgende Pakete installiert:
 apt-move
 binutils
 cfengine2
 dash
 debootstrap
 dhcp3-server
 fai-client
 fai-doc
 fai-kernels
 fai-server
 genisoimage
 libapt-pkg-perl
 mkisofs
 nfs-kernel-server
 nfs-common
 rsh-server
 syslinux
 tftpd-hpa



==== Zusätliche Software ====
 # aptitude install gcc vim mknbi rsh-client ntpdate
 Die folgenden NEUEN Pakete werden zusÃ€tzlich automatisch installiert:
  cpp cpp-4.1 gcc-4.1 libc6-dev libmudflap0 libmudflap0-dev libssp0 linux-kernel-headers vim-runtime
 Die folgenden NEUEN Pakete werden zusÃ€tzlich installiert:
  cpp cpp-4.1 gcc gcc-4.1 libc6-dev libmudflap0 libmudflap0-dev libssp0 linux-kernel-headers mknbi ntpdate rsh-client vim
  vim-runtime
 0 Pakete aktualisiert, 14 zusÃ€tzlich installiert, 0 werden entfernt und 0 nicht aktualisiert.

== NFS-Server einrichten ==
<b>Folgende Konfigurationsdateien müssen angepasst werden:</b>
 /etc/export       | Freigabe der NFS-Shares für die Clients frei
 /etc/netgroup     | Legt fest, welche Client-PCs zugreifen dürfen

====Beispiel-Conf /etc/exports====
 <nowiki>
 # /etc/exports: the access control list for filesystems which may be exported
 #		to NFS clients.  See exports(5).
 #
 /files/scratch 172.27.0.0/255.255.0.0(ro) 127.0.0.1(ro)
 /files/scripts 172.27.0.0/255.255.0.0(ro) 127.0.0.1(ro)
 /usr/local/share/fai @faiclients(ro) 172.27.0.0/255.255.0.0(ro) 127.0.0.1(ro)
 /usr/lib/fai/nfsroot @faiclients(ro,no_root_squash) 172.27.0.0/255.255.0.0(ro,no_root_squash) 127.0.0.1(ro)
 </nowiki>

====Beispiel-Conf /etc/netgroup====
 <nowiki>
# etc/netgroup 
#
# Einzelne Client-Def.
#
li-sua-101 (li-sua-101,,)
li-sua-102 (li-sua-102,,)
debian-fai (debian-fai,,)

# Gruppe
li-sua-clients li-sua-101 li-sua-102 

# Fai-Clients
faiclients li-sua-clients
 </nowiki>

Jetzt noch die Freigaben anlegen, falls noch nicht vorhanden
 # mkdir -p /files/scratch
 # mkdir -p /files/scripts
 # mkdir -p /usr/local/share/fai
 # mkdir -p /usr/lib/fai/nfsroot

Erstes starten des NFS-Servers
 # rpc.mountd
 # rpc.nfsd
 # /etc/init.d/nfs-common start
 # /etc/init.d/nfs-kernel-server start
 
Nach dem start sollte folgende Ausgabe auf der Console zu sehen sein:
   Export list for fai-sarge:
      /files/scripts        172.27.0.0/255.255.0.0
      /files/scratch        172.27.0.0/255.255.0.0
      /usr/lib/fai/nfsroot  @faiclients,172.27.0.0/255.255.0.0
      /usr/local/share/fai  @faiclients,172.27.0.0/255.255.0.0

== Fai-Server einrichten ==
<b>Konfigurationsdateien des FAI-Servers :</b>
*/etc/fai/fai.conf
*/etc/fai/make-nfs-root.conf
*/etc/fai/source.list

====/etc/fai/====
<U>Grundkonfiguration anpassen.</u>
<br><b>!!! Achtung !!!</b><br>
Wenn in diesen Dateien Änderungen vorgenommen werden, <br>muss danach <b>fai-setup</b> bzw. <b>make-fai-nfsroot</b> <br>aufgreufen werden.
Sonst werden die Änderungen nicht wirksam.
=====fai.conf=====
Diese Eintsellungen müssen vorgenommen werden.
Optionale Einstellungen werden hier nicht aufgeführt

*Der INSTALLSERVER muss über DNS aufgelöst werden
 <b>installserver=</b>INSTALLSERVER
*Wird zum erzeugen des nfs-root benötigt
 <b>mirrorhost=</b>ftp.debian.org
*Wenn der Fai-Server mehrere Netwerkkarten
 <b>SERVERINTERFACE=</b>eth0
*Zum speichern der Installations-Logfiles
 <b>FAI_REMOTESH=</b>rsh
 <b>FAI_REMOTECP=</b>rcp
*Pfadt zu den Scripten für die Clientinstallaton
 <b>FAI_CONFIGDIR=</b>/usr/local/share/fai
 <b>FAI_LOCATION=</b>$installserver:$FAI_CONFIGDIR
*Pfadt des nfsroot-Verzeichnisses
 <b>NFSROOT=</b>/usr/lib/fai/nfsroot
*Konfigurationsverzeichnis auf dem Client
 <b>FAI=</b>/fai

=====make-nfs-root.conf=====
Anpassungen des Basispaketes im nfs-root
Auch hier nur die Einstellungen die angepasst werden müssen

*Mirror-Server (z.B. Siegel oder Apt-Proy)
 <b>FAI_DEBOOTSTRAP=</b>"sarge <nowiki>http://$mirrorhost/debian</nowiki>"

* Root-Passwort (fai)
 <b>FAI_ROOTPW=</b>'$1$kBnWcO.E$djxB128U7dMkrltJHPf6d1'

*Bootkernel der Clients
 <b>KERNELPACKAGE=</b>/usr/lib/fai/kernel/linux-image-2.6.16-fai-kernels_1_i386.deb

*Exportiert die nfsroot für die angegebene Netzgruppe
 <b>FAICLIENTS=</b>"172.27.0.0/16"
*Pakete die nicht benötigt werden. 
 <b>FAI_DEBOOTSTRAP_OPTS=</b>"--exclude=pcmcia-cs,ppp,pppconfig,pppoe,pppoeconf,dhcp-client
                        exim4,exim4-base,exim4-config,exim4-daemon-light,mailx,at 
                        fdutils,info,modconf,libident,logrotate,exim"


*Pakete die zusätzlich zur nfs-root hinzu gefügt werden
 <b>packages=</b>"fai-nfsroot module-init-tools dhcp3-client ssh rdate lshw hwinfo portmap
 bootpc rsync wget rsh-client less dump reiserfsprogs usbutils
 psmisc pciutils hdparm smartmontools parted mdadm lvm2
 dnsutils ntpdate dosfstools cvs jove xfsprogs xfsdump
 sysutils dialog discover mdetect libnet-perl netcat libapt-pkg-perl
 console-tools"

=====source.list=====
In diesem Beispiel wird ein [[apt-proxy|APT-Proxy]] eingebungen.

<u><b>Beispiel</b></u>
 # These lines should work for many sites
 # A more comprehensive example can be found in /usr/share/doc/fai/examples/etc
 #
 # Internet
 ##########
 # deb <nowiki>http://ftp.debian.org/debian sarge main contrib non-free</nowiki>
 # deb <nowiki>http://ftp.debian.org/debian sarge-proposed-updates main contrib non-free</nowiki>
 # deb <nowiki>http://security.debian.org/debian-security sarge/updates main contrib non-free</nowiki>
 #
 # Debian-Proxy local
 ####################
 deb <nowiki>http://fai-sarge:9999/debian stable main contrib non-free</nowiki>
 deb-src <nowiki>http://fai-sarge:9999/debian stable main contrib non-free</nowiki>
 deb <nowiki>http://fai-sarge:9999/debian-non-US stable/non-US main contrib non-free</nowiki>
 deb-src <nowiki>http://fai-sarge:9999/debian-non-US stable/non-US main contrib non-free</nowiki>
 deb <nowiki>http://fai-sarge:9999/security stable/updates main contrib non-free</nowiki>
 
 deb <nowiki>http://fai-sarge:9999/fai/ sarge koeln</nowiki>
 deb <nowiki>http://fai-sarge:9999/blb/ stable blb</nowiki>
 deb <nowiki>http://fai-sarge:9999/marillat/ sarge main</nowiki>

== DHCP3-Server einrichten ==
Nach der Instalaltion wie oben beschrieben, ist der DHCP3 Server schon installiert.
Nun muss nur noch die Konfiguration an die eigenen Bedürfnisse angepasst werden. Hier ein Beispiel auf dem FAI-Paket 
'''fai-doc''', zu finden unter '''/usr/share/doc/fai-doc/examples/etc/dhcpd.conf'''

 # dhcpd.conf for fai
 # replace faiserver with the name of your install server
 
 deny unknown-clients;
 option dhcp-max-message-size 2048;
 use-host-decl-names on;
 #always-reply-rfc1048 on;
 
 filename "pxelinux.0";
 
 # the server from which to load the initial boot file if different
 # from server-name (if the DHCP server is not also the TFTP server)
 #next-server faiserver;
  
 subnet 192.168.1.0 netmask 255.255.255.0 {
   option routers 192.168.1.250;
   option domain-name "beowulf";
   option domain-name-servers 192.168.1.250;
   option time-servers faiserver;
   option ntp-servers faiserver;
   server-name "faiserver";
 }
 
 # perl -ane ' {print "host atom {hardware ethernet $1;fixed-address atom}";}'
 host demohost {hardware ethernet 0:2:a3:b5:c5:41;fixed-address demohost;}

== BOOTP-Server einrichten ==
Ein Beispiel zur Erklärung:

 # /etc/bootptab: database for bootp server (/usr/sbin/bootpd)
 ....
 .faiglobal:\
        :ms=1024:\
        :hd=/boot/fai:\
        :hn:bs=auto:\
        :rp=/usr/lib/fai/nfsroot:
 
 .failocal:\
        :tc=.faiglobal:\
        :sa=172.27.1.11:\
        :ts=172.27.1.11:\
        :T170="172.27.1.11:/usr/local/share/fai":\
        :T171="sysinfo":\
        :T172="sshd verbose createvt":\
        :sm=255.255.0.0:\
        :gw=172.27.0.254:\
        :dn=blb-intranet.de:\
        :ds=172.27.1.15:

 # Beispiel-Client
 li-sua-101:ha=0060085c7868:bf=li-sua-101:ip=172.27.5.101:tc=.failocal:T171="install":

* Um die Mac-Adresse des Clients heraus zu finden, kann '''"tcpdump"''' verwendet werden. Man bootet den Client und benutzt "tcpdump" auf dem Server zum auslesen:
 tcpdump -x -X -s 10000 -i eth0 dst port 67

=Erweiterte Konfiguration=
====Module in den Bootkernel (Installation) einbinden====
* Unter '''/usr/local/share/fai/class''' befindet sich das Script '''20-hwdetect.source'''.
Hier können zusätzliche Kernel-Module angegeben werden. Diese werden dann bei der Installation eingebunden.
 # load additional kernel modules (from old 11modules.source)
 # this order should also enable DMA for all IDE drives
 kernelmodules="rtc floppy usbkbd ide-disk ide-cd"
 case $(uname -r) in
 -->   2.4*) kernelmodules="$kernelmodules keybdev mousedev hid ide-detect isa-pnp" ;;
 -->   2.6*) kernelmodules="$kernelmodules usbhid usbmouse ide-generic mptspi ata_piix sata_sil" ;;
 esac
 
 for mod in $kernelmodules; do
     [ "$verbose" ] && echo loading kernel module $mod
     modprobe -a $mod 1>/dev/null 2>&1
 done

= Fai Client-Installation =
[[Fai-Client]]

[[Kategorie:Anwendungen]]
[[Kategorie:Linux]]