Skip to content

Commit b088497

Browse files
authored
Update TROUBLESHOOTING.md
1 parent b54e6ee commit b088497

1 file changed

Lines changed: 47 additions & 0 deletions

File tree

docs/TROUBLESHOOTING.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,50 @@
1919
- Verify installer paths in script
2020
- Check file permissions on USB drive
2121
- Ensure installers support silent installation
22+
23+
---
24+
25+
### "Sysinternals tools not found"
26+
**Solution:** Use launcher Menu Option 5 to auto-download, or manually download from [live.sysinternals.com](https://live.sysinternals.com)
27+
28+
### "Execution policy" errors
29+
**Solution:** Use launcher Menu Option 3, or run: `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force`
30+
31+
### "Access denied" / Permission errors
32+
**Solution:** Right-click launcher and choose "Run as administrator"
33+
34+
### Script crashes immediately on startup (v2.2 original only)
35+
**Solution:****FIXED** - Use `SystemTester.ps1` instead. Original had missing `Initialize-Environment` function.
36+
37+
### Tool verification (Menu Option 4) crashes
38+
**Solution:****FIXED** - Use `SystemTester.bat` and `SystemTester.ps1`. Missing function has been added.
39+
40+
### AMD GPU not detected (multi-GPU systems)
41+
**Solution:****FIXED** - Script now checks ALL registry subkeys (\0000, \0001, \0002, etc.), not just \0000.
42+
43+
### GPU-Z appears corrupted
44+
**Solution:****FIXED** - Launcher now validates file size (should be >1MB). Re-download if size is too small.
45+
46+
### SMART test runs DISM/SFC instead
47+
**Solution:****FIXED** - Incorrect code has been removed from SMART test function.
48+
49+
### Windows Update check fails
50+
**Solution:** Ensure Windows Update service is running; may require administrator rights
51+
52+
### GPU tests show "SKIPPED"
53+
**Solution:**
54+
- For NVIDIA: Install latest drivers from nvidia.com
55+
- For AMD: Install latest drivers from amd.com/support
56+
- nvidia-smi is included with NVIDIA drivers
57+
- Some GPU tests don't require special tools and should always work
58+
- **Note:** AMD detection now properly checks all registry locations
59+
60+
### Tests taking too long
61+
**Expected:** Some tests are intentionally slow:
62+
- CPU Performance: 10-30 seconds
63+
- Power/Energy Report: 15-20 seconds (admin only)
64+
- Windows Update Search: 30-90 seconds
65+
- DISM/SFC Scans: 5-15 minutes each (admin only)
66+
- DirectX Diagnostics (dxdiag): Up to 50 seconds
67+
68+
---

0 commit comments

Comments
 (0)