reorganized Config file
[hdw-linux/hdw-linux.git] / doc / FAI
diff --git a/doc/FAI b/doc/FAI
index 85ccef8..9917e62 100644 (file)
--- a/doc/FAI
+++ b/doc/FAI
@@ -16,14 +16,15 @@ files:
 procedure
 ---------
 
-       1) install mnimal nfsroot binaries
+       1) install minimal nfsroot binaries
 
-               vi Config [enter default as a target, specify arch*]
+               vi Config [specify arch* variables]
 
-       note: default target is enough. you dont need to specify fai-server.
-             we are just going to install the nfsroot which will automate
-             the install process. fai-server is actually the target you will
-             need as a running system to have pxeboot/nfsutils and stuff.
+       note: you dont need to specify fai-server as a target. we are just
+             going to install the nfsroot which will automate the install
+             process. the packages of the fai-server target have to be running
+              on the computer on which you are right now following these
+              instructions.
 
        note: you might want to fetch hdw binaries from a mirror.
              edit your /etc/hdw-get.conf file.
@@ -32,7 +33,12 @@ procedure
 
                where <nfsroot> is the directory to install the fairoot.
 
-       2) edit the following files to match your needs, and restart services
+       2) adapt the hdw-get.conf file in the fai nfsroot tree
+
+       note: again you might want to use a mirror. edit hdw-get.conf, but make
+             sure it is the one from fairoot.
+
+       3) edit the following files to match your needs, and restart services
 
                /etc/dhcpd.conf
                /etc/inetd.conf
@@ -41,13 +47,11 @@ 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.
+       4) adapt configs in ./fai (see chapter "fai config files")
 
-       3) adapt configs in ./fai (see chapter "fai config files")
-
-       4) pxeboot your install candidates. this is actually not fully
-          automated.
+       5) pxeboot your install candidates. this is actually not fully
+          automated. have a look athe bootdisk section if your client does
+          not support pxeboot.
 
                - type "fai" on pxeboot prompt
                - after first bootup, use cfdisk to partition your harddisk
@@ -55,8 +59,7 @@ procedure
                  (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.
+       6) optional: login, build a new kernel or do other modifications.
 
 
 fai config files
@@ -155,6 +158,36 @@ there are several files you need to hack. here we go:
 
 note: restart all the mentioned services.
 
+bootdisk
+--------
+
+for computers old enough to not support pxe but having installed a piece
+of hardware called floppy disk, you may create a bootdisk containing the
+install kernel (the pxe stuff is replaced by the bootdisk).
+
+- compile a customized kernel <= 1.3 mb. do not unset needed features!
+
+       (use ./misc/arch/${hdw_arch}/linux.config as .config + modify)
+
+- copy bzImage to fai/files/boot/vmlinuz_custom/<ip>
+
+- create bootfloppy image
+
+       dd if=/dev/zero of=bootdisk.img bs=1024 count=1440
+       yes | mke2fs -q -i 40000 -m 0 bootdisk.img
+       mkdir -p /mnt/tmp ; mount -o loop bootdisk.img /mnt/tmp
+       mkdir -p /mnt/tmp/{boot,etc} ; cp bzImage /mnt/tmp/boot/vmlinuz
+       cp misc/fai/lilo.conf /mnt/tmp/etc/lilo.conf
+       (change boot, disk map and image values)
+       touch /mnt/tmp/boot/map # enough? if not take yours from /boot
+       lilo -C /mnt/tmp/etc/lilo.conf
+       umount /mnt/tmp
+       (you may store bootdisk.img in the clients config space)
+
+       finaly: (create the boot floppy)
+
+       dd if=bootdisk.img of=/dev/floppy/0
+
 troubleshooting
 ---------------