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>

FAI 4                                            3 november 2010                                       fai-cd(8)