rewrite backup mode explaination for qemu

* try to stress the data consistency implications before going to the
 technical implementation
 * reoderder chapter levels to be consistent with the rest of the page
This commit is contained in:
Emmanuel Kasper 2016-09-05 15:06:12 +02:00 committed by Dietmar Maurer
parent 12b0494133
commit c7678c11fd

View File

@ -33,54 +33,60 @@ system. Proxmox VE backups are always full backups - containing the VM/CT
configuration and all data. configuration and all data.
Backups can be started via the GUI or via the `vzdump` command line tool. Backups can be started via the GUI or via the `vzdump` command line tool.
Backup Storage .Backup Storage
--------------
Before a backup can run, a backup storage must be defined. Before a backup can run, a backup storage must be defined.
Refer to the Storage documentation on how to add a storage. A backup storage Refer to the Storage documentation on how to add a storage. A backup storage
must be a file level storage, as backups are stored as regular files. must be a file level storage, as backups are stored as regular files.
In most situations, using a NFS server is a good way to store backups. In most situations, using a NFS server is a good way to store backups.
You can save those backups later to a tape drive, for off-site archive. You can save those backups later to a tape drive, for off-site archive.
Scheduled Backup .Scheduled Backup
----------------
Backup jobs can be scheduled so that they are executed automatically on Backup jobs can be scheduled so that they are executed automatically on
specific days and times, for selectable nodes and guest systems. specific days and times, for selectable nodes and guest systems.
Configuration of scheduled backups is done at the Datacenter level in the GUI, Configuration of scheduled backups is done at the Datacenter level in the GUI,
which will generate a cron entry in /etc/cron.d/vzdump. which will generate a cron entry in /etc/cron.d/vzdump.
Backup modes
------------
There are several ways to provide consistency (option `mode`), There are several ways to provide consistency (option `mode`),
depending on the guest type. depending on the guest type.
.Backup `mode` for VMs: .Backup modes for VMs:
`stop` mode:: `stop` mode::
This mode provides the highest consistency of the backup, at the
This first performns a clean shutdown of the VM to make sure it is cost of a downtime in the VM operation.
stopped. It then starts the VM in suspended mode and uses the qemu It works by executing an orderly shutdown of the VM, and then runs a background
backup feature to dump all data. If the VM was running, we start Qemu process to backup the VM data. After the backup is complete, the
(resume) it immediately after starting the qemu backup task. This Qemu process resumes the VM to full operation mode if it was previously running.
keeps the downtime as low as possible.
`suspend` mode:: `suspend` mode::
This mode does not really make sense for qemu. Please use snapshot This mode is provided for compatibility reason, and suspends the VM before
mode instead. calling the `snapshot` mode. Since suspending the VM results in a longer
downtime and does not necessarily improve the data consistency,
the use of the `snapshot` mode is recommended instead.
`snapshot` mode:: `snapshot` mode::
This mode simply starts a qemu live backup task. If the guest agent This mode provides the lowest operation downtime, at the cost of a small
is enabled (`agent: 1`) and running, it calls 'guest-fsfreeze-freeze' inconstancy risk.
and 'guest-fsfreeze-thaw' to improve consistency. It works by performing a Proxmox VE live backup, in which data blocks are copy
while the VM is running. If the guest agent is enabled (`agent: 1`) and running,
it calls 'guest-fsfreeze-freeze' and 'guest-fsfreeze-thaw' to improve
consistency.
A technical overview of the Proxmox VE live backup for QemuServer can A technical overview of the Proxmox VE live backup for QemuServer can
be found online be found online
https://git.proxmox.com/?p=pve-qemu-kvm.git;a=blob;f=backup.txt[here]. https://git.proxmox.com/?p=pve-qemu-kvm.git;a=blob;f=backup.txt[here].
NOTE: Qemu backup provides snapshots on any storage type. It does NOTE: For VMs, this _snapshot_ mode relates to the fact that the backup is
not require that the underlying storage supports snapshots. performed while the VM is running. This has here nothing to do with file systems
snapshots and can be operated on any kind of storage.
.Backup modes for Containers:
.Backup `mode` for Containers:
`stop` mode:: `stop` mode::