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 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 cdrecord(1).
-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 mkisofs 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://www.informatik.uni-koeln.de/fai.
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>