Product SiteDocumentation Site

⁠37.12. Файл конфигурации vzdump.conf

Глобальные настройки резервного копирования задаются в файле /etc/vzdump.conf. Каждая строка файла имеет следующий формат: 
OPTION: value
Пустые строки и строки, начинающиеся с символа #, игнорируются.
⁠

Таблица 37.3. Параметры файла конфигурации

Опция
Описание
bwlimit: <целое число> (0 — N) (по умолчанию 0)
Ограничение пропускной способности ввода/вывода (КиБ/с)
compress: (0|1|gzip|lzo|zstd) (по умолчанию 0)
Метод сжатия (по умолчанию — без сжатия)
dumpdir: <строка>
Каталог для сохранения резервных копий
exclude-path: <массив>
Исключить определенные файлы/каталоги. Пути, начинающиеся с /, привязаны к корню контейнера, другие пути вычисляются относительно каждого подкаталога
fleecing: [[enabled=]<1|0>] [,storage=<ID хранилища>]
Отложенное копирование (только для ВМ):
  • enabled (по умолчанию 0) — включение отложенного резервного копирования. Данные резервных копий из блоков, в которые происходят новые записи гостевой системы временно сохраняются в указанном хранилище, а не копируются напрямую в целевое хранилище резервных копий. Это может повысить производительность ввода-вывода гостевой системы и даже предотвратить её зависание, но требует дополнительного дискового пространства;
  • storage — хранилище для временного размещения образов отложенного копирования. Для эффективного использования пространства рекомендуется использовать локальное хранилище, которое поддерживает очистку неиспользуемых блоков (discard) и, либо тонкое выделение ресурсов (thin provisioning), либо разреженные файлы (sparse files).
ionice: <целое число> (0 — 8) (по умолчанию 7)
Настройка приоритета ввода-вывода при использовании планировщика BFQ. Для резервных копий ВМ в режимах снимка (snapshot) и приостановки (suspend) этот параметр влияет только на работу компрессора (а не на основное копирование данных). Значение 8 означает, что используется приоритет простоя (idle), в противном случае используется стандартный приоритет (best-effort) с указанным уровнем
lockwait: <целое число> (0 — N) (по умолчанию 180)
Максимальное время ожидания для глобальной блокировки (в минутах)
mailnotification: (always|failure) (по умолчанию always)
Устарело: следует использовать цели и триггеры уведомлений. Указание, когда следует отправить отчет по электронной почте
mailto: <строка>
Устарело: следует использовать цели и триггеры уведомлений. Разделенный запятыми список адресов электронной почты или пользователей, которым будут приходить уведомления
maxfiles: <целое число> (1 — N) (по умолчанию 1)
Устарело: следует использовать prune-backups. Максимальное количество файлов резервных копий ВМ
mode: (snapshot|stop|suspend) (по умолчанию snapshot)
Режим резервного копирования
notes-template: <строка>
Шаблон примечания с переменными: {{cluster}}, {{guestname}}, {{node}} и {{vmid}}. Шаблон должен быть записан в одну строку, новая строка и обратная косая черта должны быть экранированы как \n и \\ соответственно
notification-mode: <auto | legacy-sendmail | notification-system> (по умолчанию auto)
Способ отправки уведомлений. Если установлено значение legacy-sendmail, vzdump будет учитывать параметры mailto/mailnotification и отправлять электронные письма на указанные адреса с помощью команды sendmail. Если установлено значение notification-system, уведомление будет отправлено через систему уведомлений PVE, а параметры mailto/mailnotification будут проигнорированы. Если установлено значение auto (настройка по умолчанию) и установлено значение параметра mailto, будет использоваться режим legacy-sendmail, если значение параметра mailto не установлено, будет использоваться режим notification-system
pbs-change-detection-mode: <data | legacy | metadata>
Определяет метод, используемый PBS для обнаружения изменений в файлах контейнера и выбора оптимального формата кодирования при резервном копировании:
  • legacy — все файлы упаковываются в единый архив без разделения на потоки (формат pxar версии 1);
  • data — чтение и кодирование всех файлов, с разделением данных и метаданных на отдельные потоки (формат pxar версии 2);
  • metadata — разделение потоков (формат pxar версии 2), использует метаданные из предыдущего снимка (если есть) для обнаружения неизмененных файлов и повторного использования этих фрагментов данных без чтения содержимого файлов с диска
performance: [max-workers=<целое число>][,pbs-entries-max=<целое число>]
max-workers=<целое число> (1 — 256) (по умолчанию 16)
pbs-entries-max=<целое число> (1 — N) (по умолчанию 1048576)
Другие настройки, связанные с производительностью:
  • max-workers — максимальное количество параллельных операций ввода-вывода (IO), выполняемых во время резервного копирования (применяется к ВМ);
  • pbs-entries-max — применяется к резервным копиям контейнеров, отправляемым в PBS. Ограничивает количество файловых записей, хранящихся в памяти во время резервного копирования, чтобы предотвратить нехватку памяти (OOM). Следует увеличить значение этого параметра для ускорения обработки резервных копий контейнеров с большим количеством файлов (слишком высокое значение может привести к риску исчерпания памяти)
pigz: <целое число> (по умолчанию 0)
Если N=0 при сжатии резервных копий используется gzip. Если N>0 — используется pigz.
При N=1 pigz использует половину ядер CPU, при N>1 pigz работает в многопоточном режиме с указанным количеством потоков (N)
pool: <строка>
Резервное копирование ВМ из указанного пула
protected: boolean
Пометить копию как защищённую
prune-backups: [keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]
Политика хранения (переопределяет настройки хранилища см.выше)
remove: boolean (по умолчанию 1)
Удалить старые резервные копии, если их больше, чем установлено опцией prune-backups
script: <строка>
Скрипт, выполняемый до/после копирования
stdexcludes: boolean (по умолчанию 1)
Исключить временные файлы и файлы журналов
stopwait: <целое число> (0 — N) (по умолчанию 10)
Максимальное время ожидания до остановки гостевой системы (минуты)
storage: <строка>
Целевое хранилище
tmpdir: <строка>
Временный каталог (рекомендуется — быстрый локальный диск)
zstd: <целое число> (default = 1)
Количество потоков для сжатия zstd.
При N=1 zstd использует половину доступных ядер CPU, при N>1 zstd работает в многопоточном режиме с указанным количеством потоков (N)
Пример файла vzdump.conf: 
tmpdir: /mnt/fast_local_disk
storage: my_backup_storage
mode: snapshot
bwlimit: 10000