atlas-fleet/docs/SETUP.md

52 lines
1.9 KiB
Markdown

# USB Kit Setup Guide
## Vereisten
- Bootable Windows USB (gemaakt via Rufus of Media Creation Tool)
- HP EliteBook (of andere HP laptop met digitale Pro-licentie in BIOS)
## Stap 1: Bestanden op USB zetten
Kopieer naar de **root** van de USB:
- `autounattend.xml`
Kopieer naar **Scripts/** op de USB:
- `Scripts/Setup-Laptop.ps1`
- `Scripts/fleet.config` (hernoem van fleet.config.example, vul echte Tailscale key in)
- `Scripts/HPImageAssistant.exe` (download van hp.com/support als je HPIA wilt)
## Stap 2: Boot van USB
1. HP: F9 voor boot menu
2. Kies de USB
3. Windows installeert volledig automatisch (geen klikken)
## Stap 3: Setup-Laptop.ps1
Start automatisch na Windows-installatie:
1. Kies toetsenbord (AZERTY/QWERTY, 60s timeout = QWERTY)
2. WiFi verbinding (MET_Wifi / Metmet2021)
3. Windows Update inschakelen
4. HP Image Assistant: alle drivers installeren
5. Windows activering via BIOS digitale licentie
6. Computernaam instellen: ATLAS-[serienummer laatste 6 chars]
7. Tailscale enrollen + MeshCentral agent installeren
8. Administrator uitschakelen, opruimen, herstart
## Debug: wat ging er fout?
Na een mislukte of geslaagde install staan logs op:
- `C:\AtlasDebug\setup-phases.log` — welke stap succesvol/mislukt
- `C:\AtlasDebug\setup-transcript_*.txt` — volledige console output
- `C:\AtlasDebug\hardware-info.txt` — BIOS model, serial, editie, activering
- `C:\AtlasDebug\panther\*.log` — Windows PE setup logs
**Als USB aanwezig is bij einde setup:** logs worden auto-gekopieerd naar `E:\AtlasLogs`.
## Bekende bugs (opgelost in v2)
| Bug | Symptoom | Oplossing |
|---|---|---|
| Core edition key op Pro BIOS | Setup crasht zonder foutmelding | Geen ProductKey in XML — BIOS bepaalt editie |
| Path-concatenatie fout in specialize | fleet.config niet gekopieerd | [IO.Path]::Combine() gebruikt |
| Geen logging | Bij crash weet je niks | Start-Transcript + hardware dump + USB export |