72 lines
1.6 KiB
Markdown
72 lines
1.6 KiB
Markdown
|
# 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 1–3 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>`
|