bionic (8) fai-make-nfsroot.8.gz

Provided by: fai-server_5.3.6ubuntu1_all bug

NAME

       fai-make-nfsroot - create the FAI nfsroot directory

SYNOPSIS

       fai-make-nfsroot [options]

DESCRIPTION

       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.

       -p     Preserve  ssh  configs including the keys of the root account. This will not preserve the ssh host
              keys inside the nfsroot.

       -v     Create verbose output on stdout.

       -h     Show simple help.

       -z     Use gzip for compressing the base.tar file. Default is to use xz.

NOTES

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

SEE ALSO

       exports(5), nfsd(8), fai-setup(8)

       This  program  is part of FAI (Fully Automatic Installation).  See the FAI manual for more information on
       how to use fai-make-nfsroot. The FAI homepage is http://fai-project.org.

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.
       /var/log/fai/variables
              The script will write the values of FAI_VERSION and NFSROOT to this file.

AUTHOR

       Thomas Lange <lange@informatik.uni-koeln.de>