Установка клиента RuBackup

Для возможности резервного копирования при помощи RuBackup на защищаемый сервер с БД должен быть установлен клиент RuBackup и модуль резервного копирования PostgreSQL Universal.

Для корректной работы модуля PostgreSQL Universal на узел с клиентом RuBackup необходимо установить утилиты sudo, lsof, grep, awk.

Установка пакетов клиента RuBackup производится из-под учетной записи с административными правами при помощи следующих команд (имена пакетов могут отличаться в зависимости от используемой операционной системы):

sudo dpkg -i rubackup-common.deb
sudo dpkg -i rubackup-client.deb
sudo dpkg -i rubackup-postgresql.deb

Рисунок 1. Установка пакета rubackup-client.deb

Рисунок 2. Установка пакета rubackup-postgresql.deb

При настройке клиента рекомендуется активировать функцию централизованного восстановления в тех случаях, когда предполагается восстановление СУБД из средства управления RBM.

В ходе инсталляции пакета модуля PostgreSQL Universal в системе будет создан файл настроек доступа к СУБД PostgreSQL /opt/rubackup/etc/rb_module_postgresql.conf. Измените в этом файле настройки для возможности подключения модуля к СУБД и выполнения резервного копирования (см. соответствующий раздел ниже).

При старте клиента RuBackup, в случае правильной настройки доступа к СУБД и корректной настройки самой СУБД для выполнения задач резервного копирования и восстановления, в журнальном файле /opt/rubackup/log/RuBackup.log на клиенте появится следующая запись:

Рисунок 3. Старт клиента RuBackup

Подробно процедуры подготовки к установке, инсталляция, настройка и запуск клиента СРК описаны в документе «Руководство по установке и обновлению серверов резервного копирования и Linux клиентов RuBackup».

1. Обновление конфигурационного файла

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

Может существовать 3 версии конфигурационного файла:

/opt/rubackup/etc/rb_module_postgresql.conf — текущий конфигурационный файл модуля. После слияния будет переименован в rb_module_postgresql_old.conf.
/opt/rubackup/etc/rb_module_postgresql_old.conf` — старый конфигурационный файл, который был загружен в предыдущее обновление или при установке модуля.
/opt/rubackup/etc/rb_module_postgresql_upgrade.conf` — конфигурационный файл обновления. Должен быть создан вручную. Данный конфигурационный файл используется для замены значения параметров при обновлении модуля. При обновлении модуля обновится и его конфигурационный файл, а значения параметров будут взяты из старого конфигурационного файла. Если же в rb_module_postgresql_upgrade.conf записано другое значение, то будет использовано оно. Это единственный способ подменить значения параметров модуля при обновлении.

Механизм слияния конфигурационных файлов запускается автоматически при обновлении пакета deb или rpm.

2. Автоматическое обновление конфигурационного файла

Автоматическое обновление конфигурационного файла выполняется при обновлении пакетов deb или rpm и не требует действий от пользователя.

Порядок автоматического обновления:

Текущий конфигурационный файл rb_module_postgresql.conf переименовывается в rb_module_postgresql_old.conf.
Создается файл /opt/rubackup/etc/rb_module_postgresql.conf, который далее будет использован в качестве текущего.
В созданный файл rb_module_postgresql.conf добавляются параметры конфигурационного файла, которые поставляются в пакете deb или rpm. При этом все параметры закомментированы (выставлен символ # перед каждой строкой).
Происходит слияние старого конфигурационного файла, конфигурационного файла обновления, и нового конфигурационного файла, который поставляется в пакете, при этом:
- Значение каждого параметра берется из конфигурационного файла обновления.
- Если в конфигурационном файле обновления параметра нет, то значение берется из старого конфигурационного файла.
- Если в старом конфигурационном файле значение параметра отсутствует, то такое значение:
  - Добавляется, если это обязательная настройка. Добавляется без значения.
  - Не добавляется, если настройка не обязательная.
- Если у обязательного параметра нет значения, то при установке пакета возникнет ошибка. Информацию об ошибке можно посмотреть в логе установки:

Рисунок 4. Информация об ошибке

В результате автоматического обновления будет обновлен конфигурационный файл rb_module_postgresql.conf. Модуль PostgreSQL Universal будет готов к работе.

При слиянии конфигурационных файлов будут удалены все комментарии из rb_module_postgresql.conf.

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