NAME¶
nfsroot.conf - nfsroot configuration for FAI
SYNOPSIS¶
/etc/fai/nfsroot.conf
DESCRIPTION¶
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.
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.
NOTES¶
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).
SEE ALSO¶
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.
AUTHOR¶
This man page was written by Thomas Lange
<lange@informatik.uni-koeln.de>.