Ubuntu Feisty 7.04 manual page repository

Ubuntu is a free computer operating system based on the Linux kernel. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

Provided by: fai-server_3.1.3ubuntu1_all

 

NAME

        make-fai-nfsroot - create the FAI nfsroot directory
 

SYNOPSIS

        make-fai-nfsroot [options]
 

DESCRIPTION

        Create  the  FAI  nfsroot  directory as pointed by $NFSROOT in the con‐
        fig_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

        -C CFDIR
               Use CFDIR as configuration directory. Default is /etc/fai.
 
        -f config_file
               Not supported any more. Use option -C instead.
 
        -K     Remove  all kernels from NFSROOT, then install a new kernel into
               the nfsroot (like -k)
 
        -k     Install a new kernel from $KERNELPACKAGE into  the  nfsroot  and
               resetup BOOTP and DHCP environments in /srv/tftp/fai.
 
        -V KERNELNAME
               Use KERNELNAME when copying the install kernel to /srv/fai/tftp.
               Default is vmlinuz-install.
 
        -v     Create verbose output on stdout.
 
        -h     Show simple help.
 
        -r     Attempt to recover a previously failed run of this command.
 

NOTES

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

RECOVERY

        CAUTION!   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  recov‐
        ery  of a previous run.  As tasks are completed, stamp files are gener‐
        ated 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, setup_bootp_stamp, setup_dhcp_stamp.
 
        The order in which the stamp files are created are as follows:
 
        call_debootstrap_stamp
               Debootstrap was called successfully.
 
        create_base_stamp
               Created after successfully calling debootstrap plus a couple  of
               other tasks.
 
        upgrade_nfsroot_stamp
               The  packages  in  $NFSROOT have successfully been upgraded with
               apt.
 
        add_packages_nfsroot_stamp
               New packages have been installed with apt as  specified  by  the
               $NFSPACKAGES environment variable in /etc/fai/fai.conf.
 
        copy_fai_files_stamp
               FAI copies a base of files to the NFSROOT directory.
 
        setup_ssh_stamp
               The  SSH  environment is set up.  You could probably remove this
               stamp alone to refresh your ssh setup.
 
        create_nfsroot_stamp
               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.
 
        install_kernel_nfsroot_stamp
               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.
        This  program  is  part of FAI (Fully Automatic Installation).  See the
        FAI manual for more information on how to  use  make-fai-nfsroot.   The
http://www.informatik.uni-koeln.de/fai.
fai-setup(8)
 

FILES

        /etc/fai/fai.conf
               The FAI configuration file.
        /etc/fai/make-fai-nfsroot.conf
               The configuration file for make-fai-nfsroot.
        /etc/fai/apt/sources.list
               Copy this file to the NFSROOT.
        /var/run/fai/make-fai-nfsroot/*-stamp
               Stamp files used for recovery.
 

AUTHOR

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

Sections

What does Ubuntu mean?
Ubuntu is an African word meaning 'Humanity to others', or 'I am what I am because of who we all are'. The Ubuntu distribution brings the spirit of Ubuntu to the software world.