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
- Mac laptops usually have a colored ring 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 computer is off and the battery is charging.
- Drain power cache: with computer off, take out battery, unplug from charger, and hold down power button for 15 seconds. Can sometimes fix a Mac that won't boot.
- Sometimes Mac laptops won't boot and it's necessary to reset the Power Management Unit. For instructions on how to do this, go here: http://docs.info.apple.com/article.html?artnum=14449#faq10 If you first remove the battery, on the inside of the casing you will find the specs of the machine including the Processor speed so you will know which set of instructions to use.
- Reset PRAM and NVRAM: on boot, hold down Apple + Option + P + R. Wait for the chime to happen, then restarts and happens again, then release and see if it boots.
- Boot in Verbose mode: on boot, hold down Apple + V. Watch for errors as Mac boots, and google any errors found.
- 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.