Резервное копирование

Как делать резервное копирование

Резервные копии сохраняются:

автоматически при каждом обновлении Apiary;
вручную по команде пользователя (или из другого скрипта, такого как cron).

Функциональность резервного копирования реализована в форме двух сервисных утилит для создания и восстановления резервной копии. Для выполнения резервного копирования доступно две опции:

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

В обоих случаях при выполнении резервного копирования производится копирование всех сырых данных с диска.

Настройки резервного копирования

Резервные копии сохраняются в папку /opt/hw-fh_backup.

По умолчанию хранятся только последние 3 копии. Это значение можно изменить при помощи опции product.backup.depth в user.ini. Для этой опции можно не выполнять реконфигурацию или задать в качестве аргумента командной строки в случае создания ручной резервной копии.

Старые резервные копии удаляются, когда превышают лимит хранимых резервных копий.

Создание резервной копии

Чтобы создать резервную копию Apiary, выполните следующую команду с правами администратора:

/opt/hw-fh/bin/full-backup

Дополнительные опции:

-f, --force — создание резервной копии без подтверждающего вопроса;
-w, --warm — создание "тёплой" резервной копии: останавливаются все службы, за исключением служб хранения.
-h, --help — краткая информация об опциях резервного копирования;
backup_depth — количество хранимых резервных копий (целое число). Если не указано, то берется значение из параметра product.backup.depth в файле user.ini. Если и там не задано, то берется значение 3.

Обратите внимание, что этот скрипт можно запускать не только вручную, но и через cron. Мы рекомендуем регулярно делать резервные копии при помощи cron и /opt/hw-fh/bin/full-backup.

Восстановление данных из резервной копии

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

/opt/hw-fh/bin/backup-restore

Далее запустите Apiary:

systemctl start hw-fh

Дополнительные опции:

-h, --help — краткая информация об опциях резервного копирования;
-f, --file — явное указание пути до файла резервной копии. Если не указано, то будет использован последний файл из /opt/hw-fh_backup;
-l, --list — список файлов в директории /opt/hw-fh_backup, готовых для восстановления из бэкапа;
-q, --quiet — восстановление из резервной копии без подтверждающего вопроса.

Восстановление данных из резервной копии на чистой машине

Для восстановления данных из резервной копии на чистой машине выполните следующие шаги:

Установите Apiary на чистую машину.
Скопируйте файл резервной копии в любую удобную директорию. Например, в /opt/backups.

Выполните команду (требуются права root):

/opt/hw-fh/bin/backup-restore --file /opt/backups/backup_2025.08.19T20.16.02Z.tgz

Введите Y, чтобы подтвердить восстановление данных из бэкапа.
Запустите Apiary:
```
systemctl start hw-fh
```