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

72 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Snapshot Runbook — Before Major Changes
**Last Updated:** 2026-02-07
**Purpose:** Create Proxmox snapshots before major changes for quick rollback.
**See:** [OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md), [PRE_START_CHECKLIST.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)
```bash
# 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)
```bash
qm snapshot <VMID> pre-<change>-$(date +%Y%m%d)
qm listsnapshot <VMID>
qm rollback <VMID> pre-<change>-YYYYMMDD
```
### Via SSH from repo
```bash
# 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>`