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):

Restore oracle (txlog-level):

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 версии рекомендуется:

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

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

Remote Admin Flow (updated 2026-04-23)

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

Remote admin flow:

• angara-cli backup ... --remote-admin (или через configured admin endpoint).
• Runbooks в angarabook/src/operations/ теперь ссылаются на packaged CLI вместо прямого вызова dev-скриптов.

last_reviewed: 2026-04-23. Drift resolved.