76782073c2
- 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.
149 lines
3.1 KiB
Markdown
149 lines
3.1 KiB
Markdown
# ✅ 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. 🚀
|