Previous page

Next page

Locate page in Contents

Print this page

Backup Configuration File

This file ( /etc/vzbackup.conf ) is in the same format as the global Parallels Server Bare Metal configuration file and per-Container configuration files. All the parameters define the global backup settings, but some of them may be overridden by the per-server configuration file, if the latter exists. Still, other parameters may be further overridden in the configuration file of a particular Container.

Note: The backup settings in the /etc/vzbackup.conf file do not apply to virtual machines. To configure the backup parameters of virtual machines, use the prlsrvctl utility.

All-server parameters:

Parameter

Description

Default value

BACKUP_DIR

The backup directory, i.e. the directory where backups are stored.

/vz/backup

BACKUP_TYPE

The backup type. Among the supported types are "plain full ( F )", "full ( I )", and "incremental ( i )". The default is incremental. If it is impossible to do an "incremental" backup, a "full" backup will be made.

i

BACKUP_NODES

The hostname of the server whose Containers are to be backed up. You can specify several hostnames of your servers and separate them by spaces. If you wish to back up Containers residing on the Backup server itself, you should specify its hostname as the value of this parameter.

BACKUP_MAX_CHLD

The maximal number of servers to back up in parallel for non-periodic backups.

1

BACKUP_MAX_CHLD_CRON

The maximal number of servers to back up in parallel for periodic backups.

3

BACKUP_NOTIFY_EMAIL

The e-mail addresses where to send notifications about the backing up.

BACKUP_COMPRESS

Specifies whether the Containers are to be compressed when being backed up, and with what compression algorithm. When backing up Containers, you can set this option to one of the following values:

  • C0 : in this case the Container backup is created without any compression. Using this level of compression, you may greatly reduce the backup creation time; however, the size of the resulting backup file may significantly increase as compared to other compression levels.
  • C1 : in this case the Container backup is created with a normal level of compression.
  • C2 : in this case the Container backup is created with the high level of compression. The size of the resulting backup file is smaller than that of the backup file compressed in the 'normal' and 'none' modes; however, it takes longer to create the backup file.
  • C3 : in this case the Container backup is created with the maximal level of compression. The size of the resulting backup file is the smallest and the time of the backup creation - the longest.

This parameter can be overridden by the -Cg , -Cb , -Cn command-line options of the vzbackup utility.

none

CRON_BACKUP

Specifies whether the backing up is performed as a cron job. If set to "yes", the values of the BACKUP_KEEP_MAX and BACKUP_LOADAVG_MAX parameters in the given file are taken into consideration. This parameter can be overridden by the -p or -j command-line switch of the vzbackup utility.

no

Per-server parameters:

Parameter

Description

Default value

BACKUP_SSH_OPTS

Options which are passed to ssh when it is used.

-c blowfish

BACKUP_VESTOP

Defines whether the Containers are to be stopped before their backing up. If set to –s , the Containers are stopped by default, otherwise, they are not stopped.

BACKUP_EXCL_VES

Defines those Containers that are to be excluded from the backup list. Container IDs must be given here.

BACKUP_LOADAVG_MAX

The maximal loadavg with which backing up is allowed. This parameter is effective only if the -p option is specified with the vzbackup utility.

10

BACKUP_FINISH_TIME

The time when the backing up should be stopped and delayed until the next execution, e.g. when running backup scripts at 4am, one can require the backup to be finished before 7am. The backup will continue from the last Container at the next execution. The format is: " HH:MM ". This parameter is effective only if the -L option is specified with the vzbackup utility.

none

BACKUP_LIMIT_TIME

The number of hours after which the backing up should be stopped and delayed until the next execution. The format is: " HH ". This parameter is effective only if the -L option is specified with the vzbackup utility.

none

Per-Container parameters

Parameter

Description

Default Value

BACKUP_CHAIN_LEN

An incremental backup parameter. After this number of incremental backups, a full backup is performed.

7

BACKUP_CHAIN_DAYS

An incremental backup parameter. After this number of days a full backup is performed.

7

BACKUP_KEEP_MAX

The number of backups to store. Only full and plain full backups are accounted. If a regular backup is being performed that exceeds this number, the oldest backup is automatically deleted. This parameter is effective only if the -p option is specified with the vzbackup utility. If there is no -p option, the number of backups to store is not limited whatever the value of this parameter.

3

If you want to rewrite the per-server parameters for a particular Parallels server, you should create a new configuration file named server.conf and put it to the backup directory (defined by the BACKUP_DIR parameter in the global backup configuration file.