Files
loc_az_hci/docs/troubleshooting/ACCESS_PATHS_VISUAL.md
defiQUG c39465c2bd
Some checks failed
Test / test (push) Has been cancelled
Initial commit: loc_az_hci (smom-dbis-138 excluded via .gitignore)
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-08 09:04:46 -08:00

143 lines
6.0 KiB
Markdown

# 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