AppleJack is a user friendly troubleshooting assistant for Mac OS X. AppleJack lets you troubleshoot a computer even when you can’t load the GUI, or don’t have a startup CD handy. AppleJack runs in Single User Mode and is menu-based for ease of use.
AppleJack 1.3 allows you to:
- Repair your hard drive
- Repair permissions
- Validate .plist preference files and remove them if they are damaged
- Clear out system and user cache files
- Delete obstinate swap files
all without having to remember any other command than ‘applejack’.
To use AppleJack, simply reboot your computer (for example, after a system freeze) in single user mode (by holding down cmd+s) and type ‘applejack’:
- You can type ‘man applejack’ in a terminal window for complete usage instructions.
- Restart your computer. When the “bong” sounds, hold down the command and s keys until you get lots of text appearing on a black screen. You are now in single user mode. If you’ve used the installer, you should just be able to type ‘applejack’ at the prompt and be on your way.
- Auto mode: You can let the script run through its tasks automatically by typing ‘applejack auto’ or ‘applejack auto reboot’ (if you also want the machine to restart when finished).
- Interactive mode: To run through just one task, or to run the script manually, type ‘applejack’ and then choose from the menu. Running the script in interactive mode has the added benefit of giving you options for working with user level cache and preference files, not just the default system level caches and preferences.
- Corrupted preference files are moved into /Library/Preferences (Corrupt). After running AppleJack, you’ll probably want to take a look at them (and most likely throw them out).
- AppleJack now has a primitive logging mechanism. It writes a journal of its activity to /var/log/AppleJack.log. Please feel free to delete this file after you’ve looked at it. The log resets itself automatically whenever it reaches more than 500k in length.