vzdump.conf.5-opts.adoc

   1 `bwlimit`: `<integer> (0 - N)` ('default =' `0`)::
   2
   3 Limit I/O bandwidth (KBytes per second).
   4
   5 `compress`: `<0 | 1 | gzip | lzo | zstd>` ('default =' `0`)::
   6
   7 Compress dump file.
   8
   9 `dumpdir`: `<string>` ::
  10
  11 Store resulting files to specified directory.
  12
  13 `exclude-path`: `<string>` ::
  14
  15 Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root,  other paths match relative to each subdirectory.
  16
  17 `ionice`: `<integer> (0 - 8)` ('default =' `7`)::
  18
  19 Set CFQ ionice priority.
  20
  21 `lockwait`: `<integer> (0 - N)` ('default =' `180`)::
  22
  23 Maximal time to wait for the global lock (minutes).
  24
  25 `mailnotification`: `<always | failure>` ('default =' `always`)::
  26
  27 Specify when to send an email
  28
  29 `mailto`: `<string>` ::
  30
  31 Comma-separated list of email addresses or users that should receive email notifications.
  32
  33 `maxfiles`: `<integer> (1 - N)` ::
  34
  35 Deprecated: use 'prune-backups' instead. Maximal number of backup files per guest system.
  36
  37 `mode`: `<snapshot | stop | suspend>` ('default =' `snapshot`)::
  38
  39 Backup mode.
  40
  41 `notes-template`: `<string>` ::
  42
  43 Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future.
  44 +
  45 NOTE: Requires option(s): `storage`
  46
  47 `pigz`: `<integer>` ('default =' `0`)::
  48
  49 Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.
  50
  51 `pool`: `<string>` ::
  52
  53 Backup all known guest systems included in the specified pool.
  54
  55 `protected`: `<boolean>` ::
  56
  57 If true, mark backup(s) as protected.
  58 +
  59 NOTE: Requires option(s): `storage`
  60
  61 `prune-backups`: `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ('default =' `keep-all=1`)::
  62
  63 Use these retention options instead of those from the storage configuration.
  64
  65 `keep-all`=`<boolean>` ;;
  66
  67 Keep all backups. Conflicts with the other options when true.
  68
  69 `keep-daily`=`<N>` ;;
  70
  71 Keep backups for the last <N> different days. If there is morethan one backup for a single day, only the latest one is kept.
  72
  73 `keep-hourly`=`<N>` ;;
  74
  75 Keep backups for the last <N> different hours. If there is morethan one backup for a single hour, only the latest one is kept.
  76
  77 `keep-last`=`<N>` ;;
  78
  79 Keep the last <N> backups.
  80
  81 `keep-monthly`=`<N>` ;;
  82
  83 Keep backups for the last <N> different months. If there is morethan one backup for a single month, only the latest one is kept.
  84
  85 `keep-weekly`=`<N>` ;;
  86
  87 Keep backups for the last <N> different weeks. If there is morethan one backup for a single week, only the latest one is kept.
  88
  89 `keep-yearly`=`<N>` ;;
  90
  91 Keep backups for the last <N> different years. If there is morethan one backup for a single year, only the latest one is kept.
  92
  93 `remove`: `<boolean>` ('default =' `1`)::
  94
  95 Prune older backups according to 'prune-backups'.
  96
  97 `script`: `<string>` ::
  98
  99 Use specified hook script.
 100
 101 `stdexcludes`: `<boolean>` ('default =' `1`)::
 102
 103 Exclude temporary files and logs.
 104
 105 `stopwait`: `<integer> (0 - N)` ('default =' `10`)::
 106
 107 Maximal time to wait until a guest system is stopped (minutes).
 108
 109 `storage`: `<string>` ::
 110
 111 Store resulting file to this storage.
 112
 113 `tmpdir`: `<string>` ::
 114
 115 Store temporary files to specified directory.
 116
 117 `zstd`: `<integer>` ('default =' `1`)::
 118
 119 Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.
 120