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)
Метод сжатия. 0 означает отсутствие сжатия, а 1 — использование алгоритма по умолчанию (zstd)
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)
Устаревший параметр: следует использовать цели и сопоставители уведомлений. Указание, когда следует отправить отчет по электронной почте (используется при notification-mode: legacy-sendmail)
mailto: <строка>
Устаревший параметр: следует использовать цели и сопоставители уведомлений. Разделенный запятыми список адресов электронной почты или пользователей, которым будут приходить уведомления (используется при notification-mode: legacy-sendmail)
maxfiles: <целое число> (1 — N) (по умолчанию 1)
Устаревший параметр: для управления сроком хранения следует использовать prune-backups. Максимальное количество файлов резервных копий для каждой ВМ или контейнера
mode: (snapshot|stop|suspend) (по умолчанию snapshot)
Режим резервного копирования
notes-template: <строка>
Шаблон примечания с переменными: {{cluster}}, {{guestname}}, {{node}} и {{vmid}}. Шаблон должен быть записан в одну строку, новая строка и обратная косая черта должны быть экранированы как \n и \\ соответственно
notification-mode: <notification-system | legacy-sendmail>
Способ отправки уведомлений. Если установлено значение legacy-sendmail, vzdump будет учитывать параметры mailto/mailnotification и отправлять электронные письма на указанные адреса с помощью команды sendmail. Если установлено значение notification-system, уведомление будет отправлено через систему уведомлений PVE, а параметры mailto/mailnotification игнорируются
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) — максимальное количество параллельных операций ввода-вывода (IO), выполняемых во время резервного копирования (применяется к ВМ);
  • pbs-entries-max=<целое число> (1 — N) (по умолчанию 1048576) — применяется к резервным копиям контейнеров, отправляемым в PBS. Ограничивает количество файловых записей, хранящихся в памяти во время резервного копирования, чтобы предотвратить нехватку памяти (OOM). Следует увеличить значение этого параметра для ускорения обработки резервных копий контейнеров с большим количеством файлов (слишком высокое значение может привести к риску исчерпания памяти)
pigz: <целое число> (по умолчанию 0)
Если N=0 при сжатии резервных копий используется gzip. Если N>0 — используется pigz.
При N=1 pigz использует половину ядер CPU, при N>1 pigz работает в многопоточном режиме с указанным количеством потоков (N)
pool: <строка>
Пул, из которого выбираются ВМ для резервного копирования
protected: <логическое значение>
Пометить резервную копию как защищённую от удаления средствами PVE
prune-backups: [keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>] (по умолчанию keep-all=1)
Политика хранения резервных копий (переопределяет настройки хранения, заданные для хранилища)
remove: <логическое значение> (по умолчанию 1)
Включает удаление старых резервных копий в соответствии с политикой prune-backups. При значении 0 очистка старых копий не выполняется
script: <строка>
Скрипт, вызываемый на определённых этапах резервного копирования
stdexcludes: <логическое значение> (по умолчанию 1)
Включает исключение стандартных временных файлов и файлов PID при резервном копировании контейнера
stopwait: <целое число> (0 — N) (по умолчанию 10)
Максимальное время ожидания остановки гостевой системы (в минутах)
storage: <строка>
Идентификатор целевого хранилища резервных копий
tmpdir: <строка>
Каталог для временных файлов, создаваемых при резервном копировании (рекомендуется — быстрый локальный диск)
zstd: <целое число> (по умолчанию 1)
Количество потоков, используемых для сжатия алгоритмом Zstandard:
  • N=0 — используется половина доступных ядер CPU;
  • N>0 —используется указанное количество потоков
Пример файла vzdump.conf:
tmpdir: /mnt/fast_local_disk
storage: my_backup_storage
mode: snapshot
bwlimit: 10000