1
.\" Hey, EMACS: -*- nroff -*-
2
.TH fai 8 "22 june 2007" "FAI 3.2"
3
.\" Please adjust this date whenever revising the manpage.
5
.\" Some roff macros, for reference:
6
.\" .nh disable hyphenation
7
.\" .hy enable hyphenation
9
.\" .ad b justify to both left and right margins
10
.\" .nf disable filling
11
.\" .fi enable filling
12
.\" .br insert line break
13
.\" .sp <n> insert n+1 empty lines
14
.\" for manpage-specific macros, see man(7)
16
fai \- fully automatic installation
19
.RI [ options ] " ACTION"
22
.RI [ options ] " dirinstall DIRECTORY"
24
fai starts a fai-action, e.g. an installation or a softupdate.
25
If the variable FAI_ACTION is defined, this action will be
26
performed. The command line argument will override the value of
27
FAI_ACTION. You can also define your own actions which will be
28
executed when specified.
34
Use CFDIR as configuration directory. Default is /etc/fai.
36
.BI "\-c|\-\-class " class[,class]
37
Define classes. Multiple classes must be comma separated. If not
38
specified, use the shell environment variable $classes (space
39
separated). The first class has lowest priority.
42
Show help, version and summary of options.
45
Renew the list of defined classes. By default, FAI uses the list of
46
classes which was created during the first installation and skips
47
calling fai-class(1). You need to use this option for the first
48
softupdate if the system was not installed with FAI, and you can use
49
it in subsequent runs as well.
51
.B \-u|\--hostname <HOSTNAME>
52
Use this hostname instead the output of the hostname command. This is
53
useful in conjunction with the dirinstall action, where you most
54
probably want to manually define a hostname that should be used for
55
defining classes and for the network setup and other stuff. There, you
56
most probably don't want the name of the host where you run fai
57
dirinstall on be used - because programs in a chroot, or in a
58
virtualized OS instance should run on their own name, and install
59
their own set of classes.
62
Create verbose output.
66
starts an fully automatic installation:
69
setup the fai environment (create ramdisk, get configuration data,...)
71
define classes and variables
73
partition the local hard disk and create file systems
75
install new software packages
77
call configuration scripts
79
check and save the logfiles
84
starts a system rescue system
87
setup the fai environment (create ramdisk, get configuration data,...)
89
define classes and variables
91
do different types of hardware detection and print hardware info
101
fetch FAI configuration according to /etc/fai/fai.conf
103
define classes and variables
105
update the installed packages
109
call configuration scripts
111
check and save the logfiles
116
Installation into a directory. This is nearly the same as action
117
install except for skipping the task that partitions the hard disks and
118
creates the file systems. Classes can be defined with option -c, or by
119
giving the hostname with -u or --hostname and enabling automatic definition
120
by class scripts from hostname with -N. (Without -N class scripts aren't
124
Running with action "install" on an already running system will almost
125
certainly destroy it.
128
fai -v dirinstall /srv/etchroot -cDEFAULT,FAIBASE,LAST
130
This command will do an installation into the directory
131
/src/etchroot. For defining variables, selecting the software packages
132
and calling the customization script the classes DEFAULT, FAIBASE and
137
This program is the central part of FAI (Fully Automatic Installation). See
138
the FAI manual for more information on how to use FAI.
139
The FAI homepage is http://www.informatik.uni-koeln.de/fai.
142
This manual page was written by Henning Glawe
143
<glaweh@physik.fu-berlin.de> and Thomas Lange <lange@informatik.uni-koeln.de>.
added
removed
man/fai.8
