This repository has been archived on 2026-08-17. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
debian-configuration/docs/01-hardware-node1.md
T
beatzaplenty a854412117 Initial planning docs and hardening scripts for HA rebuild
Covers node 1 hardware/network layout, LVM-thin -> ZFS migration path,
Ceph as the future HA storage upgrade, and baseline SSH/firewall
hardening.
2026-07-20 11:45:54 +10:00

70 lines
2.9 KiB
Markdown

# Node 1 Hardware Layout
Build node 1 so nodes 2/3 are drop-in identical later — don't re-architect
disks or network when the cluster grows.
## Disks — three separate roles, physically separate devices
1. **Boot/OS pool (`rpool`)** — 2x small SSDs (240-480GB plenty), ZFS
mirror. Proxmox itself only. Never share with Ceph OSDs or bulk ZFS
data pools.
2. **Future Ceph OSD disks** — must end up as raw, unformatted devices —
no ZFS/RAID/LVM underneath (Ceph does its own replication; anything
underneath just doubles copy-on-write/checksumming and hurts
performance). Use enterprise SATA/NVMe SSDs with power-loss protection
(PLP) — matters far more for Ceph write latency than for general ZFS
use. Ceph needs 3 nodes minimum to go live, so on node 1 these disks
either sit idle or run as a temporary local ZFS pool to be wiped and
handed to Ceph once nodes 2/3 exist.
3. **Local ZFS "replicated tier" disks** — separate set of disks
(mirror or small raidz) for VMs kept on local storage + PVE
replication rather than Ceph (latency-sensitive or non-critical
workloads). This pool is permanent, not a placeholder.
If budget only allows one extra disk set right now: prioritize the
future-Ceph disks, run everything on ZFS locally until nodes 2/3 arrive,
then split workloads out. Avoid consumer QLC SSDs for either role — Ceph
punishes it on latency, ZFS on sync writes/scrub.
## Networking — cable and provision for the final topology now
Logically separate networks (ideally separate NICs/VLANs):
- **Management** — web UI / SSH
- **Corosync** — cluster quorum traffic, low-latency, unshared
- **Ceph public** — VM-to-OSD traffic
- **Ceph cluster/backend** — OSD-to-OSD replication (heaviest load)
Practical layout: 2x 10/25GbE bonded or split — one pair for Ceph, one
for mgmt + corosync + VM traffic, with corosync on its own VLAN even if
sharing a physical NIC. Get switch/cabling right on node 1 so nodes 2/3
are identical drops.
## CPU / RAM sizing
Size for the end state, not day one — RAM is the hardest thing to
retrofit. Budget covers:
- OS + ZFS ARC (ZFS wants RAM, not just disk)
- Ceph OSD daemons — realistically 3-5GB per OSD once running
- Actual VM workloads
Roughly a core per OSD on top of what VMs need. If OSDs won't be active
for a while, that's headway, but buy for 3 nodes' worth of eventual OSD
load.
## Backup target (PBS)
Keep it off the Ceph/compute nodes if possible — its failure domain
should be independent of the cluster. Modest separate machine or NAS:
ZFS mirror or raidz2, ECC RAM if possible, capacity for retention policy.
If it has to run as a VM inside the cluster short-term, that's a known
compromise, not the end state.
## Node 1 install sequence
1. Install Proxmox VE fresh onto the ZFS boot mirror.
2. Create the local ZFS "tier 2" pool for VM disks.
3. Leave Ceph-earmarked disks idle, or provision as a temporary ZFS pool
(to be wiped once Ceph goes live at 3 nodes).