Virsh backup-begin

This article is a Draft. Help us to complete it.

  backup-begin
      Syntax:

         backup-begin domain [backupxml] [checkpointxml] [--reuse-external]

      Begin a new backup job. If backupxml is omitted, this defaults to a full backup using a push model to filenames generated by libvirt; supplying  XML
      allows  fine-tuning  such  as requesting an incremental backup relative to an earlier checkpoint, controlling which disks participate or which file‐
      names are involved, or requesting the use of a pull model backup.  The backup-dumpxml command shows any resulting values assigned  by  libvirt.  For
      more information on backup XML, see: https://libvirt.org/formatbackup.html

      If --reuse-external is used it instructs libvirt to reuse temporary and output files provided by the user in backupxml.

      If  checkpointxml  is specified, a second file with a top-level element of domaincheckpoint is used to create a simultaneous checkpoint, for doing a
      later incremental backup relative to the time the backup was created. See checkpoint-create for more details on checkpoints.

      This command returns as soon as possible, and the backup job runs in the background; the progress of  a  push  model  backup  can  be  checked  with
      domjobinfo  or  by waiting for an event with event (the progress of a pull model backup is under the control of whatever third party connects to the
      NBD export). The job is ended with domjobabort.

See also

• virsh: Storage information, Connecting, Operations, Memory, Snapshots, Networking, CPU, release notes, virsh nodedev-list