/[fai]/branches/source-dist/INSTALL
ViewVC logotype

Contents of /branches/source-dist/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log


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

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

  ViewVC Help
Powered by ViewVC 1.1.5