mrcharles
33b5c76bec
netinfra-02 was accidentally wiped during storage moves. Rebuilt from
netinfra-01 config: Docker + Technitium (167 zones, rsync timer every 60s),
Pi-hole v6 (healthy, gravity.db validated), NTP container, ISC DHCP failover
secondary (load-balancing with primary, 99+84 active leases).
Pi-hole hardened on BOTH nodes with defense-in-depth against the
gravity.db corruption outage:
- gravity-validate.sh: pre-start SQLite header check, auto-removes corrupt DB
- Healthcheck: validates DNS resolution + gravity.db file integrity
- autoheal container: restarts unhealthy containers automatically
- Root cause (/dev/shm too small) already fixed by operator (shm_size: 1024M)
Also corrected DHCP lease count in audit (98 unique active, not 753 raw blocks).
💘 Generated with Crush
Assisted-by: Crush:glm-5.2
PFVCluster
Unified infrastructure repo for the Known Element Enterprises Proxmox R&D cluster.
→ Current Status · → Documentation Index · → Agent Guidelines
Directory Structure
| Directory | Description |
|---|---|
dcinfra/ |
Data-center infrastructure: PDU (powerman/), serial console (console/), UPS (ups/) |
netinfra/ |
DNS/NTP/DHCP setup + audit scripts, DNS cluster replication (dns-cluster-setup/), switch captures (switches/), DHCP config (dhcp/) |
k8s/ |
k3s cluster setup scripts (HA control plane over Tailscale) + co-located docs |
proxmox/ |
Proxmox fleet docs (hardware audit, capacity, storage, k8s host planning) + performance tuning (perf/) |
awx/ |
Ansible AWX deployment (k3s + AWX Operator) |
tests/ |
Test suite + VM validation harness + remote.sh SSH chokepoint |
docs/ |
Server-build docs, documentation index (docmap), and archive |
archive/ |
Historical/superseded code (provisioning → replaced by KNELIAC project) |
vendor/ |
Vendored KNELShellFramework |
Quick Start
Provision a new server
sudo bash provisioning/SetupNewSystem.sh
Validate on the sandbox VM
VM_ID=6000 ./tests/vm-validation.sh all
Deploy DNS cluster
cd dns-cluster-setup/ && ./setup.sh all
Deploy perf tunings
cd perf/ && ./deploy-tuning.sh
Architecture
- Proxmox hosts: 7 standalone PVE installs managed via PDM
- DNS: Technitium (authoritative) + Pi-hole (recursive) on pfv-netinfra-01/02
- NTP: pfv-netinfra-01/02 (redundant, LAN IPs, stratum 2/3)
- Production: Cloudron VPS in Reston VA (this cluster is R&D only)
- Backups: Proxmox Backup Server (PBS)