Тонкие настройки модуля при резервном копировании

engine

Выбор подмодуля для резервного копирования

postgresql

Подмодуль, использующий низкоуровневый API СУБД PostgreSQL для выполнения резервного копирования.

pg_probackup

Подмодуль, использующий утилиту pg_probackup для выполнения резервного копирования СУБД Postgres Pro.

superb

Подмодуль, использующий снэпшоты для выполнения резервного копирования СУБД PostgreSQL.
secret_method

Выбор метода получения аутентификационных данных (секрета) для подключения к резервируемой базе данных. Для выбора метода необходимо предварительно добавить его. Выбор предоставляется в соответствии с назначенными правами доступа авторизованного пользователя RuBackup.

No secret method

Учётные данные пользователя для подключения к резервируемой базе данных будут считаны из конфигурационного файла /opt/rubackup/etc/rb_module_postgresql.conf.

<Название метода>

Метод, который предварительно добавлен и права на который назначены пользователю; учётные данные пользователя для подключения к резервируемой базе данных будут запрошены в хранилище секретов HashiCorp Vault.

1. Подмодуль postgresql

stream

Выбор режима доставки WAL.

Чтобы использовать параметр stream с подмодулем postgresql, настройте в конфигурационном файле параметры pg_receivewal и replication_catalog.

Вкл (STREAM)

Копии типа STREAM включают все сегменты WAL, необходимые для восстановления согласованного состояния кластера на момент создания копии.

Выкл (ARCHIVE)

В режиме ARCHIVE целостность копий обеспечивается посредством непрерывного архивирования (подробнее см. на https://postgrespro.ru/docs/enterprise/).

По умолчанию

Вкл
snapshot_type

Выбор типа снимка.

lvm

Использование снэпшотов LVM.

СУБД должна располагаться в файловой системе, которая использует том LVM.

Модуль поддерживает СУБД с дополнительными табличными пространствами (tablespaces). Табличные пространства также должны располагаться в файловых системах, которые используют тома LVM.

dattobd

Использование модуля ядра dattobd, позволяющего делать снимки блочного устройства.

tatlin

Использование Tatlin Unified Storage, позволяющего делать мгновенные снимки состояния данных СУБД, которая располагается в системе хранения данных Tatlin Unified Storage.

Перед выполнением резервного копирования создаётся мгновенный снимок состояния (в зависимости от способа мгновенного снимка состояния: логического тома LVM, данных на блочном устройстве, системы хранения данных Tatlin Unified Storage), по окончанию резервного копирования мгновенный снимок состояния будет удалён.

При использовании Tatlin Unified Storage необходимо предварительно на хосте, на котором развёрнут модуль, установить утилиты multipath и sg3_utils.

По умолчанию

lvm
snapshot_size

Выбор размера снимка в процентах от размера Logical Volume тома, на котором расположены файлы базы данных, для которой выполняется резервное копирование, в случае LVM. Либо размер снимка в процентах от размера устройства, на котором расположены файлы базы данных, для которой выполняется резервное копирование, в случае использования dattobd.

В LVM volume groups, в которых расположены тома LVM, должно быть не менее 10% свободного места для возможности создания моментальных снимков LVM.

В ходе выполнения задания резервного копирования в журнальном файле задания резервного копирования (файл с номером задачи в /opt/rubackup/log) можно проконтролировать реальную утилизацию созданного снэпшота:

Snapshot '/dev/mapper/vg0-var--lib.snap' was used for: 0.92 %
The snapshot was removed: /dev/mapper/vg0-var--lib.snap

В том случае, если это значение при реальном резервном копировании близко к 100%, то необходимо увеличить размер свободного места в LVM группе и увеличить lvm_snapshot_size.

По умолчанию

10
incremental_subtype

Выбор подтипа инкрементального резервного копирования.

archive_wal

Режим инкрементального резервного копирования, при котором модуль PostgreSQL Universal выполняет резервное копирование архивных WAL-файлов.

page (страничное копирование)

В этом режиме модуль сканирует все файлы WAL в архиве с момента создания предыдущей полной или инкрементальной копии. Новая резервная копия будет содержать только страницы, на которые указывает журнал транзакций. Необходимо, чтобы в архиве WAL сохранялись все журналы транзакций, записанные после предыдущей резервной копии. Если размер этих файлов сравним с общим размером файлов базы данных, ускорение будет невелико, но размер резервной копии будет меньше.

Для работы в этом режиме необходимо настроить непрерывное архивирование журналов транзакций.

Для работы подтипа page необходимо настроить параметр конфигурационного файла pg_waldump (Конфигурационный файл /opt/rubackup/etc/rb_module_postgresql.conf).

delta (разностное копирование)

В этом режиме модуль считывает все файлы данных в каталоге данных и копирует только те страницы, которые изменились со времени предыдущего копирования. Для использования данного режима непрерывное архивирование не требуется. В этом режиме нагрузка на ввод-вывод может быть сопоставима с полным резервным копированием.

ptrack (копирование изменений)

В этом режиме модуль отслеживает изменения на лету. Этот режим не требует непрерывного архивирования журналов транзакций. Этот режим добавляет нагрузку на сервер, но значительно ускоряет инкрементальное резервное копирование.

wal_summarizer

В этом режиме используется функция обобщения журналов транзакций, появившаяся в PostgreSQL 17.
connection_monitoring

Мониторинг соединения с базой данных

По умолчанию

Вкл
compression_type

Сжатие данных.

Возможные варианты

none, fast, optimal, best

2. Подмодуль pg_probackup

stream

Выбор режима доставки WAL.

Вкл (STREAM)

Копии типа STREAM включают все сегменты WAL, необходимые для восстановления согласованного состояния кластера на момент создания копии.

Выкл (ARCHIVE)

В режиме ARCHIVE целостность копий обеспечивается посредством непрерывного архивирования (подробнее см. на https://postgrespro.ru/docs/enterprise/).

По умолчанию

Вкл
pg_pro_threads

Выбор количества параллельных потоков при резервном копировании.
pg_pro_backup_mode

Выбор подтипа инкрементального резервного копирования.

delta (разностное копирование)

В этом режиме модуль считывает все файлы данных в каталоге данных и копирует только те страницы, которые изменились со времени предыдущего копирования. Для использования данного режима непрерывное архивирование не требуется. В этом режиме нагрузка на ввод-вывод может быть сопоставима с полным резервным копированием.

page (страничное копирование)

В этом режиме модуль сканирует все файлы WAL в архиве с момента создания предыдущей полной или инкрементальной копии. Новая резервная копия будет содержать только страницы, на которые указывает журнал транзакций. Необходимо, чтобы в архиве WAL сохранялись все журналы транзакций, записанные после предыдущей резервной копии. Если размер этих файлов сравним с общим размером файлов базы данных, ускорение будет невелико, но размер резервной копии будет меньше.

Для работы в этом режиме необходимо настроить непрерывное архивирование журналов транзакций.

ptrack (копирование изменений)

В этом режиме модуль отслеживает изменения на лету. Этот режим не требует непрерывного архивирования журналов транзакций. Этот режим добавляет нагрузку на сервер, но значительно ускоряет инкрементальное резервное копирование.

По умолчанию

ptrack

3. Подмодуль superb

entire_snapshot_backup

При активировании переключателя будет выполняться резервное копирование всего снимка состояния (снэпшота) диска (логического тома LVM), на котором располагается СУБД. Если переключатель не активирован, то будет только выполняться резервное копирование данных СУБД.
snapshot_size

Выбор размера снимка в процентах от размера Logical Volume тома, на котором расположены файлы базы данных, для которой выполняется резервное копирование, в случае LVM. Либо размер снимка в процентах от размера устройства, на котором расположены файлы базы данных, для которой выполняется резервное копирование, в случае использования dattobd.

В LVM volume groups, в которых расположены тома LVM, должно быть не менее 10% свободного места для возможности создания моментальных снимков LVM.

В ходе выполнения задания резервного копирования в журнальном файле задания резервного копирования (файл с номером задачи в /opt/rubackup/log) можно проконтролировать реальную утилизацию созданного снэпшота:

Snapshot '/dev/mapper/vg0-var--lib.snap' was used for: 0.92 %
The snapshot was removed: /dev/mapper/vg0-var--lib.snap

В том случае, если это значение при реальном резервном копировании близко к 100%, то необходимо увеличить размер свободного места в LVM группе и увеличить lvm_snapshot_size.

По умолчанию

10
snapshot_type

Выбор типа снимка.

lvm

Использование снэпшотов LVM.

СУБД должна располагаться в файловой системе, которая использует том LVM.

Модуль поддерживает СУБД с дополнительными табличными пространствами (tablespaces). Табличные пространства также должны располагаться в файловых системах, которые используют тома LVM.

dattobd

Использование модуля ядра dattobd, позволяющего делать снимки блочного устройства.

tatlin

Использование Tatlin Unified Storage, позволяющего делать мгновенные снимки состояния данных СУБД, которая располагается в системе хранения данных Tatlin Unified Storage.

Перед выполнением резервного копирования создаётся мгновенный снимок состояния (в зависимости от способа мгновенного снимка состояния: логического тома LVM, данных на блочном устройстве, системы хранения данных Tatlin Unified Storage), по окончанию резервного копирования мгновенный снимок состояния будет удалён.

При использовании Tatlin Unified Storage необходимо предварительно на хосте, на котором развёрнут модуль, установить утилиты multipath и sg3_utils.

По умолчанию

lvm