NAME¶
nfsroot.conf - nfsroot configuration for FAI
SYNOPSIS¶
/etc/fai/nfsroot.conf
DESCRIPTION¶
FAI - Fully Automatic Installation - allows for non-interactive initial
installation and online maintenance ("softupdates") of operating
systems according to a user-defined configuration. See
fai(8) for the
possible operation modes of FAI.
The nfsroot is the file system which is used during installation by the install
client. It is mounted by the install kernel via NFS. It's also used on the FAI
CD.
VARIABLES¶
nfsroot.conf is sourced by
fai-make-nfsroot(8) and other scripts
and thus must be valid
bash(1) code.
- FAI_DEBOOTSTRAP
- Two parameters for debootstrap(8), space separated.
Debootstrap is called as the firt part of fai-make-nfsroot. This variable
defines SUITE and MIRROR for debootstrap. Example:
FAI_DEBOOTSTRAP="squeeze http://http.debian.net/debian"
- NFSROOT_ETC_HOSTS
- This multiline variable is added to /etc/hosts inside the
nfsroot. You can use this when DNS is not available on the clients.
Example:
NFSROOT_ETC_HOSTS="192.168.1.250 faiserver"
- FAI_ROOTPW
- The encrypted (with md5 or crypt) root password on all
install clients during the installation process. Used when log in via ssh.
This is not the password for the new installed system. Example:
FAI_ROOTPW='$1$kBnWcO.E$djxB128U7dMkrltJHPf6d1' # pw is fai
Use mkpasswd, htpasswd or md5pass for generating the password hash.
echo "yoursecrectpassword" | mkpasswd -Hmd5 -s
- NFSROOT
- Directory on the install server where the nfsroot is
created.
- TFTPROOT
- Directory on the install server for the tftp data, used by
PXE network boot.
- FAI_CONFIGDIR
- Location of the configuration space on the install server.
Used by fai-cd(8), fai-mirror(1) and fai-setup(8).
- SSH_IDENTITY
- Location of a identity.pub file. This user can log into the
install clients in as root without a password. Only useful with
FAI_FLAGS="sshd". Example:
SSH_IDENTITY=/home/admin/.ssh/identity.pub
- NFSROOT_HOOKS
- Directory of hooks to be sourced at the end of
fai-make-nfsroot, i.e. they have to be shell scripts.
- FAI_DEBOOTSTRAP_OPTS
- Options that will be passed to debootstrap(8). Used for
excluding packages and for specifying a different architecture.
FAI_DEBOOTSTRAP_OPTS="--exclude=info"
SEE ALSO¶
fai-make-nfsroot(8),
fai-setup(8),
fai(8)
This file is part of FAI (Fully Automatic Installation). The FAI homepage is
http://fai-project.org.
AUTHOR¶
This man page was written by Thomas Lange
<lange@informatik.uni-koeln.de>.
