Refactor build script for custom ISO creation and update hardware configuration

- Replaced OS-specific build method with a custom ISO builder in the build-for-hardware.sh script. - Updated output file naming to reflect the correct Alpine version in the build process. - Adjusted build dates in hardware configuration files for HP ProDesk, merged, and Start9 Pure profiles to the latest timestamp.
2026-01-31 22:56:39 +00:00
parent bd39de98e2
commit 76782073c2
23 changed files with 3285 additions and 23 deletions
@@ -0,0 +1,148 @@
+# ✅ QEMU Testing Setup Complete!
+
+## What We Installed
+
+- **QEMU 10.2.0** (full x86_64 emulation)
+- **20GB virtual disk** (`/tmp/archipelago-test-disk.qcow2`)
+- **Test script** (`test-iso-qemu.sh`)
+
+## How to Test ISOs
+
+### Quick Test:
+```bash
+cd /Users/dorian/Projects/archy/image-recipe
+./test-iso-qemu.sh
+```
+
+A QEMU window will open showing the VM booting from your ISO!
+
+### Test Specific ISO:
+```bash
+./test-iso-qemu.sh /path/to/your.iso
+```
+
+## VM Specs
+
+- **RAM**: 2GB
+- **CPU**: 2 cores
+- **Disk**: 20GB virtual disk
+- **Network**: NAT (automatically configured)
+- **Display**: VirtIO GPU
+
+## Controls
+
+- **Release mouse/keyboard**: Ctrl+Alt+G
+- **Stop VM**: Close window or Ctrl+C in terminal
+- **Fullscreen**: Ctrl+Alt+F
+
+## What to Test
+
+### 1. Boot Sequence
+- Does it boot to Alpine login? ✅ or ❌
+- Any emergency shell? ❌ (should NOT appear with overlay ISO!)
+- Does overlay load automatically?
+
+### 2. Login Test
+```
+Username: root
+Password: (just press Enter)
+```
+
+### 3. Check Overlay Loaded
+```bash
+# Check if overlay files are present
+ls -la /root/install-archipelago.sh
+ls -la /usr/local/bin/archipelago
+ls -la /usr/share/archipelago/web
+```
+
+### 4. Test Installer
+```bash
+/root/install-archipelago.sh
+```
+
+### 5. Test Alpine Installation (Optional)
+```bash
+setup-alpine
+```
+
+## Expected Boot Flow
+
+```
+1. QEMU starts
+   ↓
+2. BIOS/GRUB loads
+   ↓
+3. Alpine kernel starts
+   ↓
+4. Overlay (archipelago.apkovl.tar.gz) detected
+   ↓
+5. Overlay extracted to /
+   ↓
+6. Welcome message appears
+   ↓
+7. Login prompt
+```
+
+## Current Test Status
+
+**QEMU is currently running!** Check for the QEMU window on your screen.
+
+You should see:
+- Either Alpine boot messages scrolling by
+- Or a login prompt with the Archipelago welcome message
+
+## Stopping the VM
+
+To stop the VM:
+```bash
+# Press Ctrl+C in the terminal where you ran the script
+# Or close the QEMU window
+```
+
+## Advantages of QEMU Testing
+
+✅ **Fast**: No USB flashing needed  
+✅ **Repeatable**: Test as many times as you want  
+✅ **Safe**: No risk to physical hardware  
+✅ **Debugging**: Easy to see boot messages  
+✅ **Quick iteration**: Rebuild ISO → Test in seconds  
+
+## Workflow for Future Builds
+
+```bash
+# 1. Build new ISO
+cd /Users/dorian/Projects/archy/image-recipe
+./build-overlay-iso.sh
+
+# 2. Test in QEMU
+./test-iso-qemu.sh
+
+# 3. If it works, flash to USB for real hardware
+diskutil list
+diskutil unmountDisk /dev/diskN
+sudo dd if=results/archipelago-3.19-hp-prodesk-uefi-x86_64.iso of=/dev/rdiskN bs=1m
+```
+
+## Troubleshooting
+
+### VM doesn't start
+Check the terminal output:
+```bash
+tail -50 /Users/dorian/.cursor/projects/Users-dorian-Projects-archy/terminals/68354.txt
+```
+
+### Black screen
+- Wait 30 seconds (VM might be loading)
+- Press Enter to see if login prompt appears
+
+### Can't see QEMU window
+- Check your Dock for QEMU icon
+- Check Mission Control (Cmd+Up) for windows
+
+### VM is too slow
+This is normal - QEMU emulation (not virtualization) is slow on ARM Mac. It's still faster than flashing USB drives though!
+
+---
+
+**Look for the QEMU window on your screen now!** You should see Alpine booting. 🚀