Restoring the Directory Services Database

If the local directory database is damaged, boot into single-user mode by holding down -S as the system starts up. Next, check to see if you have a backup of the NetInfo database. The daily periodic job backs up the database each time it is run. You can find the backup in /var/backups/local.nidump. If you don’t have a backup, you won’t be able to restore. The local.nidump file is overwritten each time the cron job runs, so make sure you back it up regularly (preferably to some form of removable media).

Warning

If your computer is generally not turned on at 3:15 a.m. (the default time for the daily periodic job), you’ll never get a backup of your local directory. You can solve this problem by editing com.apple.periodic-daily.plist to run this job at a different time, or to run the job periodically with the command sudo periodic daily.

If you totally mess up and find that you forgot to backup your NetInfo database, you can stop at step 5 and issue the command rm /var/db/.AppleSetupDone. This makes Mac OS X think that it’s being booted for the first time when you restart, forcing it to run the Setup Assistant so you can create the initial user for the system, thus bringing your system to a usable state for further repairs.

After the system boots in single-user mode, you should:

  1. Wait for the root# prompt to come up.

  2. Fix any filesystem errors:

        # /sbin/fsck ...

Get Mac OS X Tiger in a Nutshell now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.