# 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:

```bash
# 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`):

```bash
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.**

