X-Git-Url: https://hackdaworld.org/gitweb/?p=hdw-linux%2Fhdw-linux.git;a=blobdiff_plain;f=doc%2FFAI;h=85ccef8696ab035dfe89530e8639cb6d9bd7db8a;hp=180ae6e80a46dd262f38c447abc3780f0f953d71;hb=b827aab00491c32a3fc9f8debaad6995d5391d83;hpb=6e75bb527068d620fe1811b09bb09e76ab29e856

diff --git a/doc/FAI b/doc/FAI
index 180ae6e..85ccef8 100644
--- 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.