finished minimal fai procedure + docu
[hdw-linux/hdw-linux.git] / doc / FAI
diff --git a/doc/FAI b/doc/FAI
index 180ae6e..85ccef8 100644 (file)
--- a/doc/FAI
+++ b/doc/FAI
@@ -10,6 +10,7 @@ files:
 ------
 
 ./scripts/Create-FAI
+./fai/*
 ./doc/FAI
 
 procedure
@@ -24,7 +25,12 @@ procedure
              the install process. fai-server is actually the target you will
              need as a running system to have pxeboot/nfsutils and stuff.
 
-               ./scripts/Create-FAI
+       note: you might want to fetch hdw binaries from a mirror.
+             edit your /etc/hdw-get.conf file.
+
+               ./scripts/Create-FAI <nfsroot>
+
+               where <nfsroot> is the directory to install the fairoot.
 
        2) edit the following files to match your needs, and restart services
 
@@ -35,15 +41,130 @@ procedure
 
                (have a look at chapter "fai server configuration")
 
+       note: again you might want to use a mirror. edit hdw-get.conf, but make
+             sure it is the one from fairoot.
+
        3) adapt configs in ./fai (see chapter "fai config files")
 
-       4) pxeboot your install candidates and watch installation
+       4) pxeboot your install candidates. this is actually not fully
+          automated.
+
+               - type "fai" on pxeboot prompt
+               - after first bootup, use cfdisk to partition your harddisk
+               - touch a disk_ready file in configuration space
+                 (after using cfdisk, sync to disk file!)
+               - reboot and finaly wathc your target system to get hdw'ed :)
+
+       5) login, build a new kernel. copy new bzImage to /boot/vmlinuz_hdw
+          and run lilo again. reboot and enjoy! good luck.
 
 
 fai config files
 ----------------
 
+       config files reside in 1) ./fai/config/<client_ip>/ and 2) ./fai/files/
+       directories.
+
+       config dir:
+
+               - the files reside in a subdirectory, which is simply the
+                 clients ip address, as different clients may need different
+                 config.
+               - files:
+                       1) disk
+                       2) packages
+
+                       disk file is used to determine the partition layout and
+                       used harddisk. the format: (example, its intuitive!)
+
+                       # disk /dev/hda
+                       # swap 7
+                       1       /boot   ext3    format
+                       5       /       ext3    format
+                       6       /home   ext3    preserve
+
+                       packages file contains packages to get installed. you
+                       may use ./scripts/Helper -create_dist_files to create
+                       one. make sure that all the packages are available on
+                       the mirror, otherwise the fai install routine will
+                       break. hint: switch the partitions to "preserve" and
+                       hdw-get will not install already installed packages
+                       again.
+                       
+        files dir:
+
+               - files called DEFAULT in a special directory will be copied to
+                 every client to the file of its dirname.
+               - files named like a clients ip address will be only copied to
+                 that client (again, the file will be the dirname)
+
+               example:
+
+               ./fai/files/etc/X11/XF86Config/DEFAULT will be copied to all
+               clients as /etc/X11/XF86Config file.
+
+
 fai server configuration
 ------------------------
 
-[to be continued]
+there are several files you need to hack. here we go:
+
+       - dhcpd:
+
+               file: /etc/dhcpd.conf
+
+               examples rule, have a look at the configuration for my fai
+               client:
+
+               ...
+               option routers 192.168.10.10;
+               option domain-name-servers 192.168.10.50, 194.25.134.203;
+               host compaq {
+                       fixed-address 192.168.10.80;
+                       hardware ethernet 00:50:8b:cb:8e:d2;
+                       allow booting;
+                       allow bootp;
+                       next-server hackstation; # the fai server
+                       server-name hackstation;
+                       filename "pxelinux.0";
+               }
+               ...
+
+       - tftpboot (you will need tftp-hpa as tftpserver)
+
+               the scripts prepared a working fai config file at
+               /tftpboot/pxelinux.cfg, just add a symbolic link of your clients
+               ip address (in hex, use: gethostip) pointing to fai.
+               ofcourse you need to have the package syslinux installed.
+
+       - nfsd:
+
+               file: /etc/exports
+
+               the scripts added export entries. just substitute "foobar" to
+               the name or ip address of your fai clients.
+
+       - inetd
+
+               file: /etc/inetd.conf
+
+               make sure the tftpboot line is uncommented. if you have problems
+               of tftpd switching to user nobody google for solutions. if you
+               are too lazy substitute "nobody" by "root in inetd.conf. this
+               is dangerous though, you have been warned.
+
+note: restart all the mentioned services.
+
+troubleshooting
+---------------
+
+contact me! -> http://www.hackdaworld.dyndns.org/contents/contact/
+email: hackbard@hackdaworld.dyndns.org
+irc: irc.hackdaworld.dyndns.org - #hackdaworld
+
+greets
+------
+
+good luck now, you are own your own! enjoy hdw. :)
+
+regards, hackbard.