Mac OSX Troubleshooting
- Mac OSX - general configuration tips for Mac OSX
- File:Mac Hardware Troubleshooting Notes.ppt
- File:Mac Software Troubleshooting (and a bit hardware).ppt
Easy Troubleshooting Steps
Quick, harmless, sometimes can help solve a problem.
- Safari: Really, really old versions of Mac can NOT run the newest version of Safari. DO NOT upgrade to the newest version of Safari unless you're sure it will be compatible with the version of Mac.
- Wireless: Leopard 10.5 won't connect to midd_secure: If the instructions at go/docs don't work, try deleting all preset profiles that relate to midd_secure, then create a new wireless "location" and try it from there. Also, try turning airport off and then back on.
- Quit the troublesome app then reopen it. (see below)
- Quit the program and delete its .plist settings file. This is found either in ~/Library/Preferences or in /Library/Preferences. Deleting it clears all settings for a program, and the program creates a new blank settings file next time you start it up.
- Create a new user account. Try starting the troublesome app in the new account. If it works fine in the new account try the next tip.
- Quit the app, move its preference file to the Desktop, reopen the app.
- Trash the app, trash its preference file. Reinstall the app.
- Try Software Update
Quitting an application on a Mac
In Mac OSX, closing the window of an application does not quit the application. Look for glowing dots (or black arrows) in front of certain applications in the Dock to see what applications are currently running. To close a running application:
- Move your cursor over the Dock icon for the app.
- Click and hold down the mouse button. A menu will appear.
- Select "Quit" and the application should close. Notice that the "Open" dot or arrow disappears, indicating that the application has been closed.
General OS or boot problems
- AC Adapter:
Mac laptops usually have a colored indicator where the AC adapter connects to the laptop, this is green when the computer is on, or when the battery is fully charged, or orange when the battery is charging. If no light appears the charger or laptop are likely faulty.
- Reset NVRAM:
Shutdown your Mac. Find Command (⌘), Option, P, and R on your keyboard. Turn on your Mac. Press and hold the Command-Option-P-R keys immediately after you hear the startup sound. Hold these keys until the computer restarts and you hear the startup sound for a second time. Release the keys. https://support.apple.com/en-us/HT204063
- Use Disk Utility First Aid:
From within OS: Follow these steps in OS X: Open Disk Utility, which is in the Utilities folder of your Applications folder. Select the startup disk from the list of volumes. Click the First Aid tab. To check permissions, click Verify Disk Permissions. To repair permissions, click Repair Disk Permissions https://support.apple.com/en-us/HT201560
From within Recovery Mode: As you Mac restarts, hold down the Command (⌘) – R Select Disk Utility and click Continue In the sidebar, select the volume you wish to repair(Macintosh HD) Click First Aid button Click Repair Disk http://www.idownloadblog.com/2016/02/26/how-to-use-disk-utility-in-mac-recovery-mode/ Safe Mode Boot:' Start or restart your Mac, then immediately press and hold the Shift key. The white Apple logo appears on your display. If you don't see the Apple logo, learn what to do. Release the shift key when you see the login window. If your startup disk is encrypted with FileVault, you might be asked to log in twice: once to unlock the startup disk, and again to log in to the Finder. To leave safe mode, restart your Mac without pressing any keys during startup. https://support.apple.com/en-us/HT201262
- Drain power cache:
Unplug machine after shutting it down Can sometimes fix a desktop Mac that won't boot.
- Boot in Verbose mode:
on boot, hold down Apple + V. Watch for errors as Mac boots, and google any errors found.
- Check Log Files:
Run Console.app to check for recent errors in Mac's log files.
What to do BEFORE doing advanced troubleshooting
- BACK UP FILES before going on to any of the advanced diagnostics and tricks below. You can use Target Disk Mode (preferred); the Ubuntu live CD also works well with Macs.
- Before trying these tricks, try installing Combo Pack updates.
- If you are suspecting/experiencing a system wide issue, always check the hardware diagnostics before taking irreversible action like an OS reinstall.
Hardware troubleshooting with diagnostics
- On newer models(built after June 2013), use Apple Diagnostics, you can start diagnostics by pressing D key on booting. https://support.apple.com/en-us/HT202731
- On older models(built before June 2013), use Apple Hardware Test, you can start diagnostics by pressing D key on booting. https://support.apple.com/en-us/HT201257
Mac doesn't wake up properly from sleep
See this article for advice: http://www.macfixit.com/article.php?story=20070129234938244
This could be an issue with a corrupt hibernation file. Deleting this file could help. A "clean" sleep/hibernation settings file will be recreated next time the computer goes to sleep. Here's how to delete it (requires admin privileges on the computer):
- Login as a user with admin privileges
- Open Terminal
cd /private/var/vm sudo rm sleepimage
(whoever is logged in, enter your own password when prompted)
- Close terminal and restart the computer
- Log in as normal and test putting the computer to sleep.
Gray progress bar appears under Apple logo during startup
A gray progress bar may appear below the Apple logo each time the computer starts up. The bar may remain a few minutes before the Finder or login window appear. Learn what to do if this happens each time you start up the computer.
If this happens each time your Mac starts up, it probably indicates Mac OS X v10.6 is attempting to diagnose and resolve an issue with your hard disk or the data on it.
- Symptom: Your Mac won't start up. You see a white or gray screen with a blinking/flashing question mark.
- Cause: The Mac cannot find the operating system. Most likely the hard disk has failed.
- Solutions: It's worth to try the following:
- Reset the PRAM (http://support.apple.com/kb/HT1379)
- (if this is a MacBook) Reseat the hard disk (Instructions: http://manuals.info.apple.com/en/MacBook_13inch_HardDrive_DIY.pdf)
- Try putting the Mac in Target Disk Mode (see below) and connect it to another Mac, then run disk utility
- If the owner has the original install DVD, it can be used to repair the OS (http://support.apple.com/kb/HT1710). The Helpdesk DOES NOT have a collection of install DVDs so they cannot help if the owner does not have the install DVD.
- If none of the above helps, then it is very likely that the hard disk has failed.
If you need to get files from the computer, you can:
- Try putting the Mac in Target Disk Mode (see below) and connect it to another Mac to copy your files.
- This may not work, and if it does not, it is an indication that the hard disk has failed completely.
- If the data on the computer is very valuable, the owner can decide to contact a Professional Data Recovery Service.
- See below for repair options.
- If the computer is under warranty, the owner must contact Apple directly (call 1-800-275-2273 OR visit the Apple-authorized repair center in South Burlington: Small Dog Electronics.
- If the computer is not under warranty:
- Self-repair or repair at the Helpdesk: depending on the model (any MacBook, late 2008 MacBook Pro), it may be possible to replace the hard disk at the Helpdesk. The owner needs to purchase a replacement hard disk (see Purchasing Replacement Parts#Apple)
- For a fee, Apple or Small Dog can repair the computer: contact Apple directly (call 1-800-275-2273 OR visit the Apple-authorized repair center in South Burlington: Small Dog Electronics.
Prevention and safeguards
Hard disks eventually fail, even when best care is taken. The best solution is to purchase an external hard drive and do regular backups. External hard drives often come with software that makes the backup process automatic. External hard drives can be purchased from http://www.amazon.com http://www.newegg.com - almost any on-line shopping site sells them these days. Good brands (no particular order): Western Digital, Seagate, LaCie...
For hard drive failure
- Try Target Disk Mode to repair disk permissions, recover files, etc. (see below)
- Check the disk integrity.
- Boot into Single User Mode by holding down Apple + S on boot.
- When system has loaded, enter
fsck -fyto check disk.
- If the OS seems corrupted but the disk is fine, consider Archive + Install. Reinstalls system without touching user files (in theory). A messed-up install might be fixed this way.
Target Disk Mode
Target Disk Mode is a feature of Mac laptops that makes Mac hardware issues much easier to troubleshoot. Basically, a laptop in TDM acts like an external hard drive, which you connect to any other computer using a Firewire cable.
TDM lets you boot a Mac using another Mac's hard drive so you can:
- Access the internal hard drive without depending on it to boot the system
- Run Disk Utility to repair disk permissions
- Run Disk Warrior for advanced repair techniques
- Power up (or shutdown and restart) the Mac.
- Immediately after powering on, hold down the t key until the Firewire icon appears on the screen (looks like a windmill).
- Now connect the Mac to another Mac using a Firewire cable. The next section explains what you can do with your Mac in TDM.
Uses for TDM
As an external hard drive
When you plug your TDM-Mac into another Mac that is already booted up and running, the TDM-Mac's hard drive will appear in the Finder as an external drive. You can browse it, and manage, copy, and move files as you could with any external drive. This option can also be used for data recovery.
As a bootable device
This is a bit more confusing: you use the computer in TDM as a boot device to start up a Mac system using the TDM hard drive but a different laptop's hardware.
To boot Mac A from Mac B's hard drive using TDM:
- Shut down Mac A.
- Boot Mac B into TDM and connect the two computers with a Firewire cable.
- Power up Mac A and immediately hold down the Option key until a window appears showing boot options.
- Select Mac B's hard drive (may be called "External hard drive" or something like that).
- Mac A will boot using Mac A's hardware but Mac B's hard disk and software.
This is really useful if you have a problem and you don't know if it's a hardware issue or a software issue. There's also some strange feature of Mac where Mac A's internal hard drive will spin more slowly - and hence, a damaged hard drive won't wear itself out as quickly - when Mac A is booting to Mac B's hard drive using TDM.