17Chapter 17 of 20
Troubleshooting
Symptoms first, then what to do — and where to look when that isn't enough.
- 1An instance won't startGreyed-out Start buttons, refusals, and what each message means.
- 2The service isn't runningWhen MSL's background service is missing, stopped, or out of date.
- 3Linux apps won't appear or openEmpty app grids, apps that won't open, and windows that misbehave.
- 4SSH won't connectNot answering on port 22, stale details, and setup that fails.
- 5The disk is fullRunning out of space inside Linux, or on your Mac.
- 6Filesystem errorsRead-only filesystems, I/O errors, and instances that won't boot — how to check and repair.
- 7The clock is wrongWrong time inside Linux after sleep or hibernation, and why it matters.
- 8The Maintenance card says…Every message the Maintenance card can show instead of working, and what to do.
- 9Memory troubleYour Mac gets slow, or programs inside Linux are killed for running out of memory.
- 10Linux has no internetWorking out where the connection stops: the gate, the guest, DNS, or your Mac.
- 11The crash screen and its stop codesWhat MSL shows when it cannot carry on, and what each code means.
- 12MSL's observerThe separate program that watches MSL, what it records, and when it interrupts you.
- 13Logs and msl doctorWhere MSL writes what it's doing, and the command that checks your installation.
- 14Reclaiming disk spaceWhat takes space on your Mac, what can go, and what can't be shrunk.