Files
proxmox/docs/03-deployment/SNAPSHOT_RUNBOOK.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

1.6 KiB
Raw Permalink Blame History

Snapshot Runbook — Before Major Changes

Last Updated: 2026-02-07
Purpose: Create Proxmox snapshots before major changes for quick rollback.
See: OPERATIONAL_RUNBOOKS.md, PRE_START_CHECKLIST.md


When to Create Snapshots

  • Before upgrading Besu or other critical services
  • Before configuration changes (nginx, NPMplus, etc.)
  • Before OS/package upgrades in containers
  • Before migration (storage, host, network)

Commands

LXC (containers)

# Create snapshot (use pct on Proxmox host)
pct snapshot <VMID> pre-<change>-$(date +%Y%m%d-%H%M%S)

# Examples
pct snapshot 1000 pre-besu-upgrade-20260207
pct snapshot 10233 pre-npmplus-config-20260207-120000

# List snapshots
pct listsnapshot <VMID>

# Rollback (if needed)
pct rollback <VMID> pre-<change>-YYYYMMDD

QEMU/KVM (VMs)

qm snapshot <VMID> pre-<change>-$(date +%Y%m%d)
qm listsnapshot <VMID>
qm rollback <VMID> pre-<change>-YYYYMMDD

Via SSH from repo

# From project root
source config/ip-addresses.conf

# Create snapshot on r630-01 for VMID 10233
ssh root@$PROXMOX_R630_01 "pct snapshot 10233 pre-change-$(date +%Y%m%d-%H%M%S)"

Retention

  • Keep 13 recent snapshots per VMID
  • Delete old snapshots: pct delsnapshot <VMID> <snapname>
  • Snapshots consume storage; monitor disk usage

Checklist

  • Identify VMIDs affected by change
  • Create snapshot on each Proxmox host for those VMIDs
  • Document snapshot names for rollback reference
  • Proceed with change
  • If rollback needed: pct rollback <VMID> <snapname>