bootcd2disk.conf(5) configuration file for bootcd2disk

DESCRIPTION

The file bootcd2disk.conf contains configuration option for the bootcd2disk(1) program of the same named package. The file must be located in the configuration directory which is usually /etc/bootcd.

Blank lines are ignored and lines with leading # are comments. Values have to be set with name=value

You can use a wildcard named DISK<number> to specify partitions instead of e.g. /dev/hda<number>. DISK was replaced by $DISK, which can be set by the same named parameter.

FORMAT

ERRLOG=<path>
Write all errors to this file. Required.

DISK=<device|auto>
Specify the disk you want to use for the installation, e.g. /dev/hda for the first IDE drive in the system. If you use "auto", bootcd2disk automatically try to use the first hard disk in the system. Required.

SFDISK=<partitions in sfdisk syntax|auto>

Configuration options for sfdisk, which creates the partitions for us. If you use "auto", we create default partitions "/", "/boot" and a swap partition. Required.

VFAT=<partitions separated by spaces>

Configure vfat partitions there, if you need some. Optional.

EXT2FS=<partitions separated by spaces|auto>

Specify partitions for ext2 FS. This partitions will be created with an ext2 filesystem. If auto is used, auto has to be used for EXT2FS, EXT3FS and EXT4FS. Auto means, that first ext4 will be tried, if this is not available ext3 is tried, and if this is not available ext2 is tried and used for "/" and "/boot" partition.

EXT3FS=<partitons separated by spaces|auto>

See EXT2FS.

EXT4FS=<partitons separated by spaces|auto>

See EXT2FS.

SWAP=<partitions separated by spaces|auto>

The partitions configured there are created as swap. If you use "auto", one swap partition is been created. Required.

MOUNT=<mount <partition> <mountpoint>; ... |auto>

Insert here the mount command line to mount your partitions or use "auto". Required. Example:

MOUNT="mount /dev/hda3 /mnt/bootcd.disc;
mkdir /mnt/bootcd.disc/boot;
mount /dev/hda1 /mnt/bootcd.disc/boot"

BIND=<mount --bind <mounted dir> <mountpoint>; ... |auto>

Insert here the mount command line to mount your partitions in a chroot environment or use "auto". Required.

UMOUNT=<umount <mountpoint>; ... |auto>

Insert here the mount command line to umount your partitions or use "auto". Required.

FSTAB=<entries for the systems fstab |auto>

Configure here all partitions you need to mount after target systems startup in the fstab syntax or use "auto". Required.

LILO=<entries for the systems lilo.conf |auto>

This variable includes the complete configuration file for the lilo bootloader on the target system. Use "auto" for automatically generated file. Only required, if you want LILO. Make sure GRUB and GRUB2 are defined as empty if you want to use LILO.

GRUB=<entries for the systems grub/menu.lst |auto>

This variable includes the complete configuration file for the grub bootloader on the target system. Use "auto" for automatically generated file. Only required, if you want GRUB.

GRUB2=<entries for the systems grub/grub.cfg |auto>

This variable includes the complete configuration file for the grub2 bootloader on the target system. Use "auto" for automatically generated file. Only required, if you want GRUB 2.

GRUBBOOTDIR=<number of partition which contains grub-dir | 0>

This variable defines the partition where the grub bootloader information is stored. You want to use this if you have defined your own partition layout and the grub information is not on the first partition. Remember that grub starts counting partitions at 0. So if you decided that /boot is on partition /dev/sda2 you need to set the parameter to 1.

GRUBBOOTDISK=<grub disk>

This should be "hd0". Only if your BIOS sees another disk as the first disk you may have to change it.

GRUBDEVICEMAP=<auto|no|<value>>
GRUBDEVICEMAP="auto" means, bootcd2disk deletes the original device.map, so that it will be auto-created by grub again. This should work also when installing on different hardware with different disks. GRUBDEVICEMAP="no" means bootcd2disk does not change device.map. This should work if a bootcd is installed on the original hardware Everything else will be used as new value for device.map.

SSHOSTKEY=<yes|no>

If you are using ssh it is helpful to have a unique ssh hostkey for each system installed with bootcd2disk. This will be generated if this option is set to "yes". Required.

UDEV_FIXNET=<yes|no>

If you are using the udev filesystem and want to install the image on other machines, you need to set this to "yes" because the network interfaces are hardwired in /etc/udev/rules.d/z25_persistent-net.rules (etch) or in /etc/udev/rules.d/70-persistent-net.rules (lenny) and we must remove them. Required.

IMAGEURL=<url>

If bootcd2disk is slow on your system (because of a slow CD/DVD drive or the HP ILO virtual CD interface), you can use a image server to get the bootcdimage from.
bootcd2disk use the swap partition of your upcoming system as temporary space and copy the image from the configured image server to this partition and use it as image. May be overwritten from command line "-url". Need the following parameter "IMAGEURL". Required. The <url> is used with wget, all url syntax from wget are possible. Please use a ip because of failed DNS and you need also the configured ip interface. May be overwritten from command line (-url). Required.
example:
IMAGEPURL="https://192.168.1.1:81/cdimage.iso"

function before_copy() {

return
}
If you want some action before copying the system to the target disk, like remount or other thinks, you can write this action to the body of this function. Optional.

function after_copy() {

return
}
If you want some action after copying the system to the target disk, like remount or other thinks, you can write this action to the body of this function. Optional.

AUTHOR

This manual page was written by Carsten Dinkelmann <[email protected]>, for the Debian GNU/Linux system (but may be used by others).