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
Если true, резервная копия будет помечена как защищенная
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