Files
loc_az_hci/docs/temporary/FINAL_INSTRUCTIONS.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

148 lines
3.3 KiB
Markdown

# Final Instructions - Complete Remaining Steps
## ✅ What's Been Completed
All automatable steps are complete:
- ✅ Environment configured
- ✅ All 4 VMs created and running
- ✅ CPU, RAM, and disk configured
- ✅ QEMU agent enabled
- ✅ All automation scripts ready
- ✅ Cloud-Init configuration attempted
## ⚠️ What Needs Manual Action
Due to Proxmox API limitations, these require Proxmox Web UI:
### 1. Verify/Fix VM Hardware (5-10 minutes)
**Access Proxmox:** https://192.168.1.206:8006
For each VM (100, 101, 102, 103):
1. Click on VM → **Hardware** tab
2. **Network Device:**
- If missing: Click "Add" → "Network Device"
- Model: VirtIO
- Bridge: vmbr0
- Click "Add"
3. **CD/DVD Drive:**
- If missing: Click "Add" → "CD/DVD Drive"
- Storage: local
- ISO image: ubuntu-24.04.3-live-server-amd64.iso
- Click "Add"
4. **Boot Order:**
- Go to **Options** tab
- Boot Order: Set to "CD-ROM" first
- Click "OK"
### 2. Install Ubuntu 24.04 (60-80 minutes)
For each VM:
1. Click VM → **Console**
2. Ubuntu installer should boot automatically
3. Complete installation with these settings:
**VM 100 - cloudflare-tunnel:**
- IP: 192.168.1.60/24
- Gateway: 192.168.1.254
- DNS: 8.8.8.8
- User: ubuntu (or your choice)
- Password: (remember for SSH)
**VM 101 - k3s-master:**
- IP: 192.168.1.188/24
- Gateway: 192.168.1.254
- DNS: 8.8.8.8
**VM 102 - git-server:**
- IP: 192.168.1.121/24
- Gateway: 192.168.1.254
- DNS: 8.8.8.8
**VM 103 - observability:**
- IP: 192.168.1.82/24
- Gateway: 192.168.1.254
- DNS: 8.8.8.8
### 3. Verify Installation (Automated)
After Ubuntu is installed on all VMs:
```bash
./scripts/check-vm-status.sh
```
This verifies:
- Network connectivity
- SSH access
- Ubuntu installation
### 4. Complete Automated Setup (Automated)
Once verification passes:
```bash
./scripts/automate-all-setup.sh
```
This will automatically:
- Install Cloudflare Tunnel (VM 100)
- Install K3s (VM 101)
- Install Gitea (VM 102)
- Install Prometheus + Grafana (VM 103)
## 🚀 Quick Start
**Option 1: Interactive Guide**
```bash
./scripts/manual-steps-guide.sh
```
**Option 2: Manual Steps**
1. Follow steps 1-2 above
2. Run: `./scripts/check-vm-status.sh`
3. Run: `./scripts/automate-all-setup.sh`
## 📋 Checklist
- [ ] Verify VM hardware via Proxmox Web UI
- [ ] Install Ubuntu on VM 100 (cloudflare-tunnel)
- [ ] Install Ubuntu on VM 101 (k3s-master)
- [ ] Install Ubuntu on VM 102 (git-server)
- [ ] Install Ubuntu on VM 103 (observability)
- [ ] Run: `./scripts/check-vm-status.sh`
- [ ] Run: `./scripts/automate-all-setup.sh`
## 🎯 Expected Timeline
- Hardware verification: 5-10 minutes
- Ubuntu installation: 60-80 minutes (15-20 min per VM)
- Automated setup: 40-60 minutes
- **Total: ~2 hours**
## 📞 Troubleshooting
**If VMs don't boot:**
- Check boot order in Proxmox (should be CD-ROM first)
- Verify ISO is attached
- Check VM has sufficient resources
**If network doesn't work:**
- Verify network device exists in Hardware tab
- Check bridge (vmbr0) exists
- Verify IP configuration during Ubuntu install
**If setup scripts fail:**
- Ensure Ubuntu is fully installed
- Check SSH access works
- Verify user has sudo privileges
## 📄 Related Documentation
- `COMPLETE_STATUS.md` - Full status report
- `VM_STATUS_REPORT.md` - Detailed VM status
- `DEPLOYMENT_PROGRESS.md` - Progress tracker