]>
Commit | Line | Data |
---|---|---|
013dc89f | 1 | `bwlimit`: `<integer> (0 - N)` ('default =' `0`):: |
d083d3d3 DM |
2 | |
3 | Limit I/O bandwidth (KBytes per second). | |
4 | ||
c5aa7e14 | 5 | `compress`: `<0 | 1 | gzip | lzo | zstd>` ('default =' `0`):: |
d083d3d3 DM |
6 | |
7 | Compress dump file. | |
8 | ||
013dc89f | 9 | `dumpdir`: `<string>` :: |
d083d3d3 DM |
10 | |
11 | Store resulting files to specified directory. | |
12 | ||
013dc89f | 13 | `exclude-path`: `<string>` :: |
d083d3d3 | 14 | |
d2656385 | 15 | Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory. |
d083d3d3 | 16 | |
013dc89f | 17 | `ionice`: `<integer> (0 - 8)` ('default =' `7`):: |
d083d3d3 DM |
18 | |
19 | Set CFQ ionice priority. | |
20 | ||
013dc89f | 21 | `lockwait`: `<integer> (0 - N)` ('default =' `180`):: |
d083d3d3 DM |
22 | |
23 | Maximal time to wait for the global lock (minutes). | |
24 | ||
013dc89f | 25 | `mailnotification`: `<always | failure>` ('default =' `always`):: |
d083d3d3 DM |
26 | |
27 | Specify when to send an email | |
28 | ||
013dc89f | 29 | `mailto`: `<string>` :: |
d083d3d3 | 30 | |
d2656385 | 31 | Comma-separated list of email addresses or users that should receive email notifications. |
d083d3d3 | 32 | |
0695fdaf | 33 | `maxfiles`: `<integer> (1 - N)` :: |
d083d3d3 | 34 | |
0695fdaf | 35 | Deprecated: use 'prune-backups' instead. Maximal number of backup files per guest system. |
d083d3d3 | 36 | |
013dc89f | 37 | `mode`: `<snapshot | stop | suspend>` ('default =' `snapshot`):: |
d083d3d3 DM |
38 | |
39 | Backup mode. | |
40 | ||
7af2edf9 TL |
41 | `notes-template`: `<string>` :: |
42 | ||
4e7f60c2 | 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. Needs to be a single line, newline and backslash need to be escaped as '\n' and '\\' respectively. |
7af2edf9 TL |
44 | + |
45 | NOTE: Requires option(s): `storage` | |
46 | ||
4e7f60c2 TL |
47 | `performance`: `[max-workers=<integer>]` :: |
48 | ||
49 | Other performance-related settings. | |
50 | ||
51 | `max-workers`=`<integer> (1 - 256)` ('default =' `16`);; | |
52 | ||
53 | Applies to VMs. Allow up to this many IO workers at the same time. | |
54 | ||
013dc89f | 55 | `pigz`: `<integer>` ('default =' `0`):: |
d083d3d3 | 56 | |
c2993fe5 | 57 | Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count. |
d083d3d3 | 58 | |
9226ccbc TL |
59 | `pool`: `<string>` :: |
60 | ||
61 | Backup all known guest systems included in the specified pool. | |
62 | ||
7af2edf9 TL |
63 | `protected`: `<boolean>` :: |
64 | ||
65 | If true, mark backup(s) as protected. | |
66 | + | |
67 | NOTE: Requires option(s): `storage` | |
68 | ||
0695fdaf | 69 | `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`):: |
739d4d64 TL |
70 | |
71 | Use these retention options instead of those from the storage configuration. | |
72 | ||
4772952b TL |
73 | `keep-all`=`<boolean>` ;; |
74 | ||
75 | Keep all backups. Conflicts with the other options when true. | |
76 | ||
739d4d64 TL |
77 | `keep-daily`=`<N>` ;; |
78 | ||
79 | Keep backups for the last <N> different days. If there is morethan one backup for a single day, only the latest one is kept. | |
80 | ||
81 | `keep-hourly`=`<N>` ;; | |
82 | ||
83 | Keep backups for the last <N> different hours. If there is morethan one backup for a single hour, only the latest one is kept. | |
84 | ||
85 | `keep-last`=`<N>` ;; | |
86 | ||
87 | Keep the last <N> backups. | |
88 | ||
89 | `keep-monthly`=`<N>` ;; | |
90 | ||
91 | Keep backups for the last <N> different months. If there is morethan one backup for a single month, only the latest one is kept. | |
92 | ||
93 | `keep-weekly`=`<N>` ;; | |
94 | ||
95 | Keep backups for the last <N> different weeks. If there is morethan one backup for a single week, only the latest one is kept. | |
96 | ||
97 | `keep-yearly`=`<N>` ;; | |
98 | ||
99 | Keep backups for the last <N> different years. If there is morethan one backup for a single year, only the latest one is kept. | |
100 | ||
013dc89f | 101 | `remove`: `<boolean>` ('default =' `1`):: |
d083d3d3 | 102 | |
0695fdaf | 103 | Prune older backups according to 'prune-backups'. |
d083d3d3 | 104 | |
013dc89f | 105 | `script`: `<string>` :: |
d083d3d3 DM |
106 | |
107 | Use specified hook script. | |
108 | ||
013dc89f | 109 | `stdexcludes`: `<boolean>` ('default =' `1`):: |
d083d3d3 DM |
110 | |
111 | Exclude temporary files and logs. | |
112 | ||
013dc89f | 113 | `stopwait`: `<integer> (0 - N)` ('default =' `10`):: |
d083d3d3 DM |
114 | |
115 | Maximal time to wait until a guest system is stopped (minutes). | |
116 | ||
013dc89f | 117 | `storage`: `<string>` :: |
d083d3d3 DM |
118 | |
119 | Store resulting file to this storage. | |
120 | ||
013dc89f | 121 | `tmpdir`: `<string>` :: |
d083d3d3 DM |
122 | |
123 | Store temporary files to specified directory. | |
124 | ||
c5aa7e14 TL |
125 | `zstd`: `<integer>` ('default =' `1`):: |
126 | ||
127 | Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count. | |
128 |