make-fai-nfsroot8

Usage

Overview

Create the FAI nfsroot directory as pointed by $NFSROOT in the config_file. This directory is necessary for the installation of Debian on remote clients using the FAI package. The config_file location is discussed in the OPTIONS below.

The exit code returned is 0 if all commands to build the root directory exited successfully and >0 if an error occurs.

Options

-a

Adjust a generic nfsroot. Add resolv.conf, add host entries, set the root password.

-B BASETGZ

Use specified BASETGZ file as base.tgz (or base.tar.gz, base.tar.xz, base.txz) for the nfsroot. This avoids calling debootstrap and therefore reduces the buildtime for the nfsroot.

-C CFDIR

Use CFDIR as configuration directory. Default is /etc/fai. You can also set the environment variable FAI_ETC_DIR.

-f

Force overwriting an existing nfsroot. By default fai-make-nfsroot aborts if the configuration variable NFSROOT points to a directory which already exists. To force overwriting (and therefore rebuilding) the existing nfsroot use this option. This option is supported starting with FAI 4.0. Note: To update and therefore preserve an existing nfsroot see option -k.

-g

Create a generic nfsroot. Remove most install server specific data from nfsroot. See also -a.

-K

Remove all kernels from NFSROOT. This is the same as calling aptitude purge ~nlinux-image inside the nfsroot.

-k

Install additional packages defined in /etc/fai/NFSROOT into the nfsroot. Also copies all kernels from the nfsroot to the directory $TFTPROOT.

-l

Create a nfsroot using live/filesystem.dir subdirectory. This is needed if the initrd of the kernel is created by the live-boot package.

-p

Preserve ssh keys. This will preserve the whole .ssh directory of the root account inside the nfsroot.

-v

Create verbose output on stdout.

-h

Show simple help.

Notes

If you do not use NFS, you may still use the NFSROOT directory as a staging point for building the base installation tarball.

Files

/etc/fai/fai.conf

The FAI configuration file.

/etc/fai/nfsroot.conf

The configuration file for fai-make-nfsroot.

/etc/fai/nfsroot-hooks/

Directory containing shell scripts to be sourced at the end of fai-make-nfsroot for additional configuration of the nfsroot. Can be changed with NFSROOT_HOOKS.

/etc/fai/apt/sources.list

Copy this file to the NFSROOT.

/etc/fai/apt/keys/*.asc

Repository keys in .asc format found here will be installed into the NFSROOT.