Nfsroot configuration for fai
/etc/fai/nfsroot.conf
The nfsroot is a file system on the install server. It is used during installation by the install clients.
nfsroot.conf defines the essential options for the install server, which are mostly used inside the nfsroot. Use bash(1) syntax for defining variables.
FAI_DEBOOTSTRAP
Two parameters for debootstrap(8), space separated. Debootstrap is called as the first part of fai-make-nfsroot. This variable defines SUITE and MIRROR for debootstrap. Example:
FAI_DEBOOTSTRAP="wheezy 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.33.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 ssh public key 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/id_rsa.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.
Normally, the nfsroot is mounted by the install kernel via NFS. It's also used on the FAI CD. You can convert an nfsroot to a compressed image using fai-nfsroot2image(8).
fai-make-nfsroot(8), fai-setup(8), fai(8) fai-mirror(1) fai-chboot(8) fai-nfsroot2image(8)
This file is part of FAI (Fully Automatic Installation). The FAI homepage is http://fai-project.org.
This man page was written by Thomas Lange <[email protected]>.