proxmox/docs/archive/HISTORICAL_VMID_REFERENCES.md

Historical VMID References

Overview

This document identifies documentation files that contain references to old VMID ranges. These are primarily historical references or examples and should be updated when actively using those documents.

Current VMID Ranges:

• Validators: 1000-1004 (was 106-110, 1100-1104)
• Sentries: 1500-1503 (was 111-114, 1110-1113)
• RPC: 2500-2502 (was 115-117, 1120-1122)

---

Documents with Old VMID References

Update When Using These Documents

These documents contain old VMID references but may still be used for reference:

1. docs/VMID_UPDATE_COMPLETE.md

   • Status: Historical migration document
   • Contains: Old → New VMID mapping table
   • Action: ✅ Keep as historical reference

2. docs/VMID_REFERENCE_AUDIT.md

   • Status: Historical audit document
   • Contains: Old VMID ranges in migration context
   • Action: ✅ Keep as historical reference

3. docs/VMID_ALLOCATION.md

   • Status: Historical allocation document
   • Contains: Old VMID ranges (1100-1122)
   • Action: ⚠️ Consider updating or marking as superseded by VMID_ALLOCATION_FINAL.md

4. docs/NEXT_STEPS_COMPREHENSIVE.md

   • Status: Contains old VMID examples
   • Contains: Examples using 1100-1122 range
   • Action: ⚠️ Update examples if actively using this document

5. docs/BESU_SETUP_COMPLETE.md

   • Status: Historical setup document
   • Contains: References to besu_balances_106_117.js script
   • Action: ⚠️ Update script name reference

6. docs/SOURCE_PROJECT_STRUCTURE.md

   • Status: Contains example VMID references
   • Contains: Examples with 106-117 range
   • Action: ⚠️ Update examples if actively using this document

7. docs/EXPECTED_CONTAINERS.md

   • Status: Contains old VMID ranges
   • Contains: 106-117 ranges in tables
   • Action: ⚠️ Update to current ranges if actively using

8. docs/COMPLETE_CONTAINER_LIST.md

   • Status: Contains old VMID ranges
   • Contains: 106-117 ranges in tables
   • Action: ⚠️ Update to current ranges if actively using

9. docs/BESU_ALLOWLIST_RUNBOOK.md

   • Status: Contains example commands with old VMIDs
   • Contains: Loops using 106-117
   • Action: ⚠️ Update examples if actively using

10. docs/RECOMMENDATIONS_AND_SUGGESTIONS.md

    • Status: Contains example commands
    • Contains: Examples with 106-110
    • Action: ⚠️ Update examples if actively using

11. docs/VALIDATION_SUMMARY.md

    • Status: Contains old VMID ranges
    • Contains: 106-117 in validation checks
    • Action: ⚠️ Update to current ranges if actively using

12. docs/DEPLOYMENT_VALIDATION_REQUIREMENTS.md

    • Status: Contains old VMID ranges
    • Contains: 106-117 in requirements
    • Action: ⚠️ Update to current ranges if actively using

13. docs/OS_TEMPLATE_CHANGE.md

    • Status: Historical change document
    • Contains: References to containers 106+
    • Action: ✅ Keep as historical reference

14. docs/UBUNTU_DEBIAN_ANALYSIS.md

    • Status: Historical analysis document
    • Contains: References to containers 106-117
    • Action: ✅ Keep as historical reference

15. docs/OS_TEMPLATE_ANALYSIS.md

    • Status: Historical analysis document
    • Contains: References to containers 106-117
    • Action: ✅ Keep as historical reference

---

Migration Path

Old → New VMID Mapping

Old Range	New Range	Type
106-110	1000-1004	Validators
111-114	1500-1503	Sentries
115-117	2500-2502	RPC
1100-1104	1000-1004	Validators (intermediate)
1110-1113	1500-1503	Sentries (intermediate)
1120-1122	2500-2502	RPC (intermediate)

---

Action Items

High Priority (Active Documents)

Update these documents if they're actively used:

• docs/BESU_SETUP_COMPLETE.md - Update script name reference
• docs/NEXT_STEPS_COMPREHENSIVE.md - Update examples
• docs/SOURCE_PROJECT_STRUCTURE.md - Update examples

Medium Priority (Reference Documents)

Consider updating these for consistency:

• docs/EXPECTED_CONTAINERS.md - Update VMID ranges
• docs/COMPLETE_CONTAINER_LIST.md - Update VMID ranges
• docs/BESU_ALLOWLIST_RUNBOOK.md - Update examples

Low Priority (Historical Documents)

Keep as historical references:

• ✅ docs/VMID_UPDATE_COMPLETE.md - Historical migration doc
• ✅ docs/VMID_REFERENCE_AUDIT.md - Historical audit doc
• ✅ docs/OS_TEMPLATE_CHANGE.md - Historical change doc
• ✅ docs/UBUNTU_DEBIAN_ANALYSIS.md - Historical analysis
• ✅ docs/OS_TEMPLATE_ANALYSIS.md - Historical analysis

---

Verification

To find all old VMID references:

# Find references to old validator VMIDs
grep -r "\b\(106\|107\|108\|109\|110\)\b" docs/ --include="*.md"

# Find references to old sentry VMIDs
grep -r "\b\(111\|112\|113\|114\)\b" docs/ --include="*.md"

# Find references to old RPC VMIDs
grep -r "\b\(115\|116\|117\)\b" docs/ --include="*.md"

# Find references to intermediate VMIDs
grep -r "\b\(1100\|1110\|1120\)\b" docs/ --include="*.md"

---

Current Configuration

Active VMID Configuration (see smom-dbis-138-proxmox/config/proxmox.conf):

VMID_VALIDATORS_START=1000          # Validators: 1000-1004
VMID_SENTRIES_START=1500            # Sentries: 1500-1503
VMID_RPC_START=2500                 # RPC: 2500-2502

All deployment scripts and active documentation should use these ranges.