loc_az_hci/docs/temporary/FINAL_INSTRUCTIONS.md

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:

./scripts/check-vm-status.sh

This verifies:

• Network connectivity
• SSH access
• Ubuntu installation

4. Complete Automated Setup (Automated)

Once verification passes:

./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

./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