Backup and Restore

Ключевой операторский baseline для backup/restore. Детали и расширенные процедуры см. в мигрированном runbook-контуре AngaraBook.

Goal

Зафиксировать проверяемый workflow:

что гарантирует backup;
как выполняется restore;
какие артефакты подтверждают корректность.

Contract (cold/offline)

Backup выполняется при остановленном сервере.
В backup включаются:
storage.data_directory (включая .adb);
storage.transaction_log_directory;
storage.undo_directory (если вынесен отдельно), либо .aud из data_directory.
Снимок консистентен на момент остановки.
Для TDE backup восстановление требует валидный key material (fail-closed).

What is out of scope

Нет hot backup в этом контракте.
Нет PITR.
Нет incremental backup.

Pinned commands

CLI (operator-facing, preferred for packaged distribution):

angara-cli backup full --config /etc/angarabase/angarabase.conf --out /tmp/base_full.abk
angara-cli backup verify --file /tmp/base_full.abk --json

Restore via CLI:

angara-cli backup restore \
  --config /etc/angarabase/angarabase.conf \
  --file /tmp/base_full.abk \
  --target-dir /tmp/angarabase-restore \
  --overwrite

Legacy tools entrypoint (workspace/dev path):

tools/backup_restore/run.sh backup \
 --data-dir /var/lib/angarabase/data \
 --txlog-dir /var/lib/angarabase/transaction_log \
 --out /tmp/angarabase-backup.tar.gz \
 --root artifacts/backup_restore/backup

tools/backup_restore/run.sh restore \
 --archive /tmp/angarabase-backup.tar.gz \
 --dest /tmp/angarabase-restore \
 --force \
 --root artifacts/backup_restore/restore

Restore oracle (txlog-level):

tools/backup_restore/oracle.sh --root artifacts/backup_restore_oracle/run_1

Evidence surfaces

Минимум для triage:

summary.json (top-level outcome);
backup_manifest.json (inspect);
verify_report.json (verify);
oracle JSON (txlog scan/replay-pages, compare.json).

Upgrade linkage

Перед upgrade версии рекомендуется:

сделать cold backup;
сохранить архив как rollback point;
прогнать restore oracle на отдельной директории.

Совместимость и on-disk policy: src/operations/upgrade-and-migration.md.

Remote Admin Flow (updated 2026-04-23 for TD-2026-0012)

Для packaged distribution (apt install angarabase-server) предпочтителен angara-cli (remote admin over TCP or local). Legacy tools/backup_restore/run.sh остаётся только для dev/workspace.

Remote admin flow:

angara-cli backup ... --remote-admin (или через configured admin endpoint).
Runbooks в angarabook/src/operations/ теперь ссылаются на packaged CLI вместо прямого вызова tools/.
Evidence: tools/ci/backup_smoke.sh + golden_db restore oracle.

last_reviewed: 2026-04-23. Drift resolved.

Keyboard shortcuts

AngaraBook