proxmox/docs/archive/VMID_REFERENCE_AUDIT.md

VMID Reference Audit Report

Generated: $(date)
New VMID Allocation: Sovereign-scale mapping (1000-8999)
Previous Allocation: Various (106-117, 1100-4700)

New VMID Mapping

Category	Old Range	New Range	Count	Notes
Besu Validators	106-110, 1100-1104	1000-1004	5	Initial, 1000-1499 available (500 VMIDs)
Besu Sentries	111-114, 1110-1113	1500-1503	4	Initial, 1500-2499 available (1000 VMIDs)
Besu RPC	115-117, 1120-1122	2500-2502	3	Initial, 2500-3499 available (1000 VMIDs)
Besu Archive/Telemetry	-	3500+	-	3500-4299 (800 VMIDs)
Besu Reserved	-	4300+	-	4300-4999 (700 VMIDs)
Blockscout	2000, 250	5000	1	5000-5099 available (100 VMIDs)
Cacti	2400, 261	5200	1	5200-5299 available (100 VMIDs)
Chainlink CCIP	3200	5400+	1+	5400-5599 available (200 VMIDs)
Fabric	4500, 262	6000	1	6000-6099 available (100 VMIDs)
Firefly	4700, 260	6200	1	6200-6299 available (100 VMIDs)
Indy	8000, 263	8000	1	8000-8999 available (1000 VMIDs)

Files Requiring Updates

Critical Scripts (Must Update)

1. Configuration Files

   • smom-dbis-138-proxmox/config/proxmox.conf ✅ Updated
   • smom-dbis-138-proxmox/config/network.conf ⚠️ Check for IP mappings

2. Deployment Scripts

   • smom-dbis-138-proxmox/scripts/deployment/deploy-besu-nodes.sh
   • smom-dbis-138-proxmox/scripts/deployment/deploy-validated-set.sh
   • smom-dbis-138-proxmox/scripts/copy-besu-config.sh
   • smom-dbis-138-proxmox/scripts/copy-besu-config-with-nodes.sh

3. Network Scripts

   • smom-dbis-138-proxmox/scripts/network/bootstrap-network.sh
   • smom-dbis-138-proxmox/scripts/network/update-static-nodes.sh

4. Validation Scripts

   • smom-dbis-138-proxmox/scripts/validation/validate-deployment-comprehensive.sh
   • smom-dbis-138-proxmox/scripts/validation/validate-validator-set.sh

5. Utility Scripts

   • scripts/besu_balances_106_117.js (rename to besu_balances.js)
   • scripts/fix-enodes-final.py
   • scripts/fix-enode-config.py
   • scripts/besu-deploy-allowlist.sh
   • scripts/besu-verify-peers.sh

Documentation Files (Update Examples)

1. Action Plans

   • ACTION_PLAN_NOW.md
   • docs/NEXT_STEPS_COMPLETE.md
   • docs/NEXT_STEPS_COMPREHENSIVE.md

2. Reference Documentation

   • docs/BESU_NODES_FILE_REFERENCE.md
   • docs/VALIDATED_SET_QUICK_REFERENCE.md
   • docs/VMID_ALLOCATION.md
   • docs/BESU_SETUP_COMPLETE.md

3. Deployment Guides

   • docs/VALIDATED_SET_DEPLOYMENT_GUIDE.md
   • docs/RUN_DEPLOYMENT.md

4. Troubleshooting

   • docs/TROUBLESHOOTING_FAQ.md

5. Quick Reference Cards

   • QUICK_START_VALIDATED_SET.md
   • NEXT_STEPS_QUICK_REFERENCE.md

Monitoring Scripts

1. scripts/monitoring/simple-alert.sh
2. scripts/monitoring/setup-health-check-cron.sh
3. scripts/monitoring/prometheus-besu-config.yml

Management Scripts

1. scripts/secure-validator-keys.sh
2. scripts/backup/backup-configs.sh
3. scripts/manage/snapshot-before-change.sh
4. scripts/manage/deploy-multi-node.sh
5. scripts/manage/expand-storage.sh
6. scripts/manage/migrate-container.sh

Update Priority

Priority 1 (Critical - Must Update Before Deployment)

• Configuration files
• Deployment scripts
• Network/bootstrap scripts
• Validation scripts

Priority 2 (High - Update Before Testing)

• Utility scripts
• Monitoring scripts
• Management scripts

Priority 3 (Medium - Update Documentation)

• All documentation files
• Quick reference cards
• Troubleshooting guides

Quick Update Commands

Find All References

cd /home/intlc/projects/proxmox
grep -r "\b\(106\|107\|108\|109\|110\|111\|112\|113\|114\|115\|116\|117\|1100\|1110\|1120\|1130\|1140\|2000\|2400\|3200\|4500\|4700\)\b" \
    --include="*.sh" --include="*.js" --include="*.py" --include="*.md" \
    smom-dbis-138-proxmox/ scripts/ docs/ | grep -v ".git"

Update Pattern Mapping

Old Pattern	New Pattern	Notes
106-110	1000-1004	Validators
111-114	1500-1503	Sentries
115-117	2500-2502	RPC
1100-1104	1000-1004	Validators (if already updated)
1110-1113	1500-1503	Sentries (if already updated)
1120-1122	2500-2502	RPC (if already updated)
2000	5000	Blockscout
2400	5200	Cacti
3200	5400	CCIP
4500	6000	Fabric
4700	6200	Firefly

Next Steps

1. ✅ Update config/proxmox.conf with new ranges
2. ⏳ Update all deployment scripts
3. ⏳ Update all utility scripts
4. ⏳ Update all documentation
5. ⏳ Test configuration loading
6. ⏳ Run dry-run deployment
7. ⏳ Execute deployment