loc_az_hci/docs/troubleshooting/ACCESS_PATHS_VISUAL.md

Access Paths Visual Map

┌─────────────────────────────────────────────────────────────────┐
│                    YOUR WORKSTATION                              │
│                                                                   │
│  SSH Key: ~/.ssh/id_ed25519_proxmox                             │
│  Browser: Access to Web UIs                                     │
│  Scripts: Automation tools                                       │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
┌──────────────┐      ┌──────────────┐      ┌──────────────┐
│  Proxmox     │      │  Proxmox     │      │  Virtual     │
│  ML110       │      │  R630        │      │  Machines    │
│              │      │              │      │              │
│ 192.168.1.206│      │ 192.168.1.49 │      │ 100-103      │
└──────────────┘      └──────────────┘      └──────────────┘
        │                     │                     │
        │                     │                     │
   ┌────┴────┐           ┌────┴────┐          ┌────┴────┐
   │         │           │         │          │         │
   ▼         ▼           ▼         ▼          ▼         ▼
┌─────┐  ┌─────┐     ┌─────┐  ┌─────┐    ┌─────┐  ┌─────┐
│Web │  │ SSH │     │Web │  │ SSH │    │Console│ │ SSH │
│UI  │  │     │     │UI  │  │     │    │      │ │     │
│✅  │  │ ✅  │     │✅  │  │ ❌  │    │ ✅   │ │ ❌  │
└─────┘  └─────┘     └─────┘  └─────┘    └─────┘  └─────┘
   │         │           │         │          │         │
   └────┬────┘           └────┬────┘         └────┬────┘
        │                     │                     │
        ▼                     ▼                     ▼
   ┌─────────┐          ┌─────────┐          ┌─────────┐
   │   API   │          │   API   │          │  QEMU   │
   │   ✅    │          │   ✅    │          │  Guest  │
   └─────────┘          └─────────┘          │  Agent  │
                                               │   ❌    │
                                               └─────────┘

Access Path Status

✅ Working Paths

Proxmox ML110 (192.168.1.206):

• ✅ Web UI: https://192.168.1.206:8006
• ✅ SSH: ssh -i ~/.ssh/id_ed25519_proxmox root@192.168.1.206
• ✅ API: https://192.168.1.206:8006/api2/json

Proxmox R630 (192.168.1.49):

• ✅ Web UI: https://192.168.1.49:8006
• ✅ API: https://192.168.1.49:8006/api2/json

Virtual Machines (100-103):

• ✅ Console: Via Proxmox Web UI
• ✅ Network: All reachable (ping)
• ✅ Port 22: All open

❌ Not Working (With Fixes)

SSH to VMs:

• ❌ Authentication failing
• 🔧 Fix: Use Proxmox console to add SSH key

SSH to R630:

• ❌ Authentication failing
• 🔧 Fix: Enable SSH and add key

QEMU Guest Agent:

• ❌ Not running in VMs
• 🔧 Fix: Install via console

Access Flow Diagram

Workstation
    │
    ├─→ Proxmox ML110 (✅ Web UI, ✅ SSH, ✅ API)
    │       │
    │       └─→ VM Console (✅ Available)
    │       └─→ QEMU Guest Agent (❌ Not installed)
    │
    ├─→ Proxmox R630 (✅ Web UI, ❌ SSH, ✅ API)
    │       │
    │       └─→ VM Console (✅ Available)
    │
    └─→ Virtual Machines (❌ SSH, ✅ Network, ✅ Console)
            │
            ├─→ VM 100: 192.168.1.60 (cloudflare-tunnel)
            ├─→ VM 101: 192.168.1.188 (k3s-master)
            ├─→ VM 102: 192.168.1.121 (git-server)
            └─→ VM 103: 192.168.1.82 (observability)

Troubleshooting Decision Tree

Need to access VM?
    │
    ├─→ SSH working? → Use SSH
    │
    ├─→ SSH not working?
    │       │
    │       ├─→ Console available? → Use Console
    │       │
    │       ├─→ QEMU Guest Agent? → Use qm guest exec
    │       │
    │       └─→ Network reachable? → Use service APIs
    │
    └─→ Need Proxmox host access?
            │
            ├─→ SSH working? → Use SSH
            │
            ├─→ SSH not working?
            │       │
            │       ├─→ Web UI available? → Use Web UI
            │       │
            │       └─→ API working? → Use API
            │
            └─→ Physical access? → Use Console/KVM

Priority Matrix

Task	Priority 1	Priority 2	Priority 3
VM Management	Web UI	SSH	API
Service Config	SSH	Console	QEMU Agent
Automation	API	SSH	Web UI
Troubleshooting	Console	SSH	QEMU Agent

---

Legend:

• ✅ Working
• ❌ Not working
• 🔧 Needs fix
• ⏳ Pending