NAME

       fai-cd - make a bootable CD-ROM or USB stick that performs an FAI

SYNOPSIS

       fai-cd [OPTION] -m MIRROR FILE
       fai-cd [OPTION] -m MIRROR -u DIRECTORY
       fai-cd [OPTION] -B FILE

DESCRIPTION

       This  command  creates  a  bootable  ISO  CD-ROM  image  that performs the fully automatic
       installation from CD-ROM without an install server. The ISO image will be written to FILE.
       To  create the image, the command needs the NFSROOT, the configuration space and a partial
       mirror, which is created by fai-mirror. The command can  also  copy  all  needed  data  to
       DIRECTORY on a mounted USB stick.

OPTIONS

       -B     Create a boot only ISO image which does a network installation. It does not include
              the nfsroot, the partitial mirror and the config space. Unless  the  option  -g  is
              used, /usr/share/fai/menu.lst will be used as boot menu configuration.

       -b     After creating the ISO image burn it by calling wodim(1) (a version of cdrecord).

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

       -f     Force removal of an existing ISO image before creating a new one.

       -G INTEGER
              Use INTEGER as version number for grub boot loader. By default, grub2 (grub-pc)  is
              used. fai-cd tries to find the named grub version in NFSROOT first. If this version
              is not installed, it downloads the appropriate grub package and  uses  these  files
              without acutally installing it.

       -g FILE
              Use FILE as grub grub.cfg/menu.lst file. The script will look for FILE in CFDIR. If
              FILE is located in another directory then a full path must  be  specified.  If  not
              specified, use /etc/fai/grub.cfg for grub2 or /etc/fai/menu.lst for grub1.

       -G GRUBVERSION
              Specify which grub version should be used. Either 1 or 2, the default is 2.

       -h     Show simple help and version.

       -H     Do  not  hide  directories. Using this option will consume 220MB more disk space on
              your media. By default, some directories like man pages and locales are hidden  and
              will not be put onto the CD or the USB stick.

       -k     Keep the temporary filesystem for debugging. The script will sleep for a long time,
              before continuing the cleanup of temp  files  and  mounts.  Beware  of  killing  or
              suspending  the  script  itself,  since  a  lot  of mounts will remain. This is for
              debugging only!

       -m DIRECTORY
              Use DIRECTORY as partial FAI mirror. This option is mandatory.

       -n     No ISO image. Do not call genisoimage to create the ISO image. This is for creating
              the filesystem only. Useful for writing it to a USB stick.

       -u DIRECTORY
              Create  a bootable USB stick. The USB stick must be mounted on DIRECTORY before you
              run fai-cd. Copies all FAI-CD data to DIRECTORY and try to install  grub  onto  its
              device.  Currently the file system on the USB stick must be ext2. USUALLY THIS WILL
              ERASE ALL DATA ON YOUR USB-STICK!

EXAMPLES

       After you've created a mirror with fai-mirror in /media/mirror, you can create a CD using:

          # fai-cd -m /media/mirror fai-cd.iso

       If you want to create a bootable USB stick, create an ext2  file  system  on  your  stick,
       mount it to /media/usbstick and call

          # fai-cd -m /media/mirror -u /media/usbstick
          # umount /media/usbstick

SEE ALSO

       This  program  is  part  of  FAI  (Fully  Automatic  Installation).   The  FAI homepage is
       http://fai-project.org.

       fai-mirror(1)

FILES

       /etc/fai/fai.conf
              The FAI configuration file.
       /etc/fai/grub.cfg
              The default grub2 menu configuration file for fai-cd.
       /etc/fai/menu.lst
              The default grub1 menu configuration file for fai-cd.
       /usr/share/fai/grub.cfg
              The default grub2 menu configuration file when using -B.
       /usr/share/fai/menu.lst
              The default grub1 menu configuration file when using -B.

AUTHOR

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