.IX Title "boocdbackup"
.TH BOOTCDBACKUP 1 "2007-07-05" "bootcdbackup" "bootcd utils"
.SH NAME
bootcdbackup \- create a bootable offline backup of a unix system
.SH SYNOPSIS
.\" The general command line
.B bootcdbackup [-i] [-v] [-s] [-c <config directory>] [-url <url] [-nomount] [-2diskconf <file>] <dev> <name> <builddir> 
.SH DESCRIPTION

.B bootcdbackup
creates a offline backup from a installed system. You need a running 
.I bootcd 
to boot the system with. This CD/DVD is booted on the system and 
.B bootcdbackup
creates a bootable CD/DVD with the bootcd kernel and the backup disk as tar-file. 

.PP

To restore or clone the system, boot the CD/DVD image and install it with
.B bootcd2disk -c <name>
on the system.

.PP
.B bootcdbackup
can try to discover the disk partition by searching for fstab on the given partition. A other way to backup the partition table is the program
.B bootcdmk2diskconf
which creates a configuration file on a running system.

.SH OPTIONS
.IX Header "OPTIONS"

.IP "\fB\-i\fR" 4
.IX Item "i"
The bootcdbackup runs in interactive mode and you can run each function manually. This option is useful for debugging.


.IP "\fB\-v\fR" 4
.IX Item "-v"
The option "\fB\-v\fR" (verbose) adds messages on running.


.IP "\fB\-s\fR" 4
.IX Item "-s"
This option can be used to disable interactive questions and to try to ignore errors.


.IP "\fB\-c <config directory>\fR" 4
.IX Item "-c <config directory>"
The configuration directory which includes the file "bootcdbackup.conf", default is "/etc/bootcd".


.IP "\fB\-url <url>\fR" 4
.IX Item "-url <url>"
If bootcdbackup is slow on your system (because of a slow CD/DVD drive or the HP ILO virtual CD interface), you can use an image server to get the image from.

bootcdbackup 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. 
The image server url is configured with this option.


.IP "\fB\-nomount\fR" 4
.IX Item "-nomount"
The target disk should not be mounted and no search for fstab is done.

.IP "\fB\--cpio\fR" 4
.IX Item "--cpio"
Normally as backup tool star will be used if selinux files have to be backed up and
cpio will be used if not. With this option the usage of cpio can be forced.

.IP "\fB\--star\fR" 4
.IX Item "--star"
Normally as backup tool star will be used if selinux files have to be backed up and
cpio will be used if not. With this option the usage of star can be forced.

.IP "\fB\-2diskconf <file>\fR" 4
.IX Item "-2diskconf <file>"
The parameter configures a
.I bootcd2disk.conf
for the restore of the system done by 
.B bootcd2disk. 
The configuration file can be created with the command
.B bootcdmk2diskconf.

.IP "\fB <dev>\fR" 4
.IX Item "<dev>"
Configures the device where bootcdbackup finds the file "fstab" and discover the configuration for the restore. 


.IP "\fB <name>\fR" 4
.IX Item "<name>"
The name of the backup (no blanks!) is used on the creation time and to restore the backup with
.B bootcd2disk -c <name>.


.IP "\fB <builddir>\fR" 4
.IX Item "<builddir>"
Builddir is an directory on the backup system where bootcdbackup build the backup CD/DVD. Space for the CD/DVD image, for compression and the data is needed!

.PP

All other configuration has to be done in the config files.

.SH FILES
.TP
.I /etc/bootcd/bootcdbackup.conf
.PP
Configuration for bootcdbackup.

.SH "SEE ALSO"
Documentation in bootcdbackup.conf
.PP
bootcdbackup.conf(5), bootcd(1), bootcdflopcp(1), bootcdwrite(1)

.SH AUTHOR
This manual page was written by Bernd Schumacher <\fIbernd.schumacher@hpe.com\fR> and Carsten Dinkelmann <\fICarsten.Dinkelmann@foobar-cpa.de\fR> for the Debian GNU/Linux system (but may be used by others).