fai-cd

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
FILES
AUTHOR

NAME

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

SYNOPSIS

fai-cd [OPTION] −m MIRROR ISOFILE
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.

Note: Currently, fai-cd is only working with the package live-boot inside the nfsroot, not with dracut. Therefore you have to use the option -l with fai-make-nfsroot(8).

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.

−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 FILE

Use FILE as grub grub.cfg 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.

−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

Do not add the package mirror to the CD.

−m DIRECTORY

Use DIRECTORY as partial FAI mirror. This option is mandatory, unless you use -M or -B.

−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.

AUTHOR

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