Section: Maintenance Commands (8)Updated: 14 june 2010Local indexUp
make-fai-nfsroot - create the FAI nfsroot directory
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.
Use specified BASETGZ file as base.tgz for the nfsroot. This avoids
calling debootstrap and therefore reduces the buildtime for the nfsroot.
Use CFDIR as configuration directory. Default is /etc/fai. You can
also set the environment variable FAI_ETC_DIR.
Not supported any more. Use option -C instead.
Remove all kernels from NFSROOT. This is the same as calling aptitude
purge ~nlinux-image inside the nfsroot.
Install additional packages defined in /etc/fai/NFSROOT into the
nfsroot. Also copies all kernels from the nfsroot to the directory $TFTPROOT.
Preserve ssh keys. This will preserve the whole .ssh directory of the
root account inside the nfsroot.
Do not divert update-initramfs during build of the nfsroot. This
will slow down the creation process a bit. Use it in case of missing
initrd inside the nfsroot or when Ubuntu fails if the diversion exists.
Create verbose output on stdout.
Show simple help.
Attempt to recover a previously failed run of this command.
If you do not use NFS, you may still use the NFSROOT
directory as a staging point for building the base installation tarball.
This is an advanced feature. You should be willing to open up an
editor and browse the make-fai-nfsroot code to understand what each task
does and how your use of the recovery option can be impacted by fiddling
around with the stamp files.
You can call make-fai-nfsroot with the '-r' option to attempt a recovery of
a previous run. As tasks are completed, stamp files are generated in
/var/run/fai/make-fai-nfsroot. As each task is called in recovery mode, the
stamp file is checked. If it exists, the task is skipped. This will save
you much time during your initial install and debug phase. It is not a very
sophisticated mechanism but it can help you on updating the nfsroot as
well. For example, if you want to update the kernel that is installed,
remove the following stamp files: install_kernel_nfsroot_stamp,
The order in which the stamp files are created are as follows:
Debootstrap was called successfully.
Created after successfully calling debootstrap plus a couple of other tasks.
The packages in $NFSROOT have successfully been upgraded with apt.
New packages have been installed with apt as specified by the $NFSPACKAGES
environment variable in /etc/fai/fai.conf.
FAI copies a base of files to the NFSROOT directory.
The SSH environment is set up. You could probably remove this stamp alone
to refresh your ssh setup.
This stamp file is created when all the preceeding steps have been taken.
You have a base nfsroot directory. All you need now is the kernel and the
BOOTP or DHCP setup.
The kernel you specified in $KERNELPACKAGE has been installed.
setup_bootp_stamp | setup_dhcp_stamp
Your kernel was either BOOTP or DHCP. The appropriate setup has been completed.