| 1 |
# $Id$
|
| 2 |
|
| 3 |
INSTALLATION
|
| 4 |
|
| 5 |
Install the newest fai Debian package using apt-get or dpkg
|
| 6 |
|
| 7 |
Even the technical report was written for fai-1.0, it's good to start
|
| 8 |
with it to understand how fai works. The directory layout has changed
|
| 9 |
and new features has beeen added to fai. Read all README files for how to
|
| 10 |
build package and harddisk configurations. Since FAI uses cfengine
|
| 11 |
during the last part of installation, reading the cfengine manual is
|
| 12 |
also recommended (http://www.iu.hioslo.no/cfengine/).
|
| 13 |
|
| 14 |
The file links.html contains links to all important web sites for FAI.
|
| 15 |
In our examples, the root password will be set to: fai
|
| 16 |
-----------------------------------------------------------------------
|
| 17 |
FAI consists of these directories
|
| 18 |
|
| 19 |
usr
|
| 20 |
.
|
| 21 |
|-- lib
|
| 22 |
| `-- fai
|
| 23 |
| |-- etc
|
| 24 |
| |-- kernel
|
| 25 |
| `-- nfsroot
|
| 26 |
|-- local
|
| 27 |
| `-- share
|
| 28 |
| `-- fai
|
| 29 |
| |-- class
|
| 30 |
| |-- disk_config
|
| 31 |
| |-- fai_config
|
| 32 |
| |-- files
|
| 33 |
| |-- package_config
|
| 34 |
| `-- scripts
|
| 35 |
|-- sbin
|
| 36 |
`-- share
|
| 37 |
`-- doc
|
| 38 |
`-- fai
|
| 39 |
|-- examples
|
| 40 |
`-- templates
|
| 41 |
|
| 42 |
|
| 43 |
|
| 44 |
fai step by step
|
| 45 |
----------------
|
| 46 |
|
| 47 |
Access to a (local) Debian mirror: via NFS, ftp or http
|
| 48 |
It's recommended to build a local mirror, in order to have access via NFS.
|
| 49 |
variables: FAI_PACKAGEDIR FAI_BASETGZ FAI_SOURCES_LIST
|
| 50 |
|
| 51 |
You have to setup a BOOTP server (bootpd) (/etc/bootptab). Fetch the
|
| 52 |
ethernet address (also called MAC address) of your network cards and
|
| 53 |
include them into bootptab. Read also README.collect_sysinfo how you
|
| 54 |
can get the ethernet addresses of your all hosts easily. There's an
|
| 55 |
example how bootptab should look like for fai.
|
| 56 |
|
| 57 |
Create a link /boot/fai/installimage, if you boot via network card or
|
| 58 |
prepare the boot floppy.
|
| 59 |
|
| 60 |
Start with T171="sysinfo" to see if your computer boots successfully.
|
| 61 |
|
| 62 |
The directory layout:
|
| 63 |
|
| 64 |
/usr/lib/fai/nfsroot contains the extracted base2_X.tgz data
|
| 65 |
/usr/lib/fai/etc apt.conf that is used by fai
|
| 66 |
/usr/lib/fai/kernel files for building kernel for tftp boot
|
| 67 |
|
| 68 |
cp -dpR /usr/share/doc/fai/templates/* /usr/local/share/fai
|
| 69 |
|
| 70 |
|
| 71 |
All base FAI scripts are located in subdirectory sbin/. The global
|
| 72 |
configuration file are in fai_config/. They are parse before the
|
| 73 |
installation begins. Subdirectory class/ contains all scripts and
|
| 74 |
files for defining classes for the client. The configuration for
|
| 75 |
partitioning the harddisk and mounting local filesystems are stored in
|
| 76 |
disk_config/. Information for software packages can be found in
|
| 77 |
packages_config/. The scripts that are executed at the end of the
|
| 78 |
installation are stored in subdirectory scripts/. Template for files
|
| 79 |
that are copied onto the clients are located in files/. Subdirectories
|
| 80 |
etc/ and kernel/ contain files for NIS and for BOOTPD and the scripts
|
| 81 |
for the building of different kernels.
|
| 82 |
|
| 83 |
These are important FAI_ Vairables:
|
| 84 |
|
| 85 |
XXXXX
|
| 86 |
|
| 87 |
|
| 88 |
|
| 89 |
|
| 90 |
FAI_NFSSERVER_USR Where the clients are going to mount the /usr
|
| 91 |
from. Not required.
|
| 92 |
|
| 93 |
read_config is used two times. This is a feature, not a bug. It can be
|
| 94 |
used, when you will not use a BOOTP server.
|
| 95 |
|
| 96 |
|
| 97 |
/boot/fai/$HOSTNAME must always be a link to an installimage !
|
| 98 |
|
| 99 |
|
| 100 |
kernelimage if it's not pointing to a debfile, it's the
|
| 101 |
version for the package kernel-image-*
|
| 102 |
|
| 103 |
|
| 104 |
Start with a minimal list of packages to install. |
Parent Directory
| 
Revision Log