How To Perform a Manual Mac System Migration [MacRx]


Manual Mac Migration

Since the days of Mac OS X 10.3 “Panther” Apple has provided a wonderful utility, Migration Assistant, to help move data between your old and new Macs. With this utility you can easily migrate your installed applications, system settings and user data from your old system to your new one.

On the whole Migration Assistant works very well, performs successfully more often than not, and has gotten better with every subsequent release of Mac OS X. However despite Apple’s best efforts there are times when Migration Assistant can’t or won’t work.

A Manual Mac System Migration is just a fancy term for copying things over. The key is knowing what needs to be moved and how to connect the two machines.

When Migration Assistant Doesn’t Work

One instance of Migration Assistant failing is when a user account is corrupt or not recognized as valid on the disk from the old system. Sometimes the program will start the transfer process but doesn’t complete, ending with an error or stalling out and bringing over some data but not all.

Another instance happens when you may be migrating from a newer to an older Mac OS X version – say a downgrade from Snow Leopard to Leopard or even Tiger. Apple typically intends the migration process to be from older to newer systems, not the reverse, but sometimes specific needs mean going back a version for stability or compatibility.

Other possibilities involve an older Mac that doesn’t have FireWire, isn’t running a Mac OS X version that supports network migration, or can’t be connected to a network at all.  Or, you may just prefer a more fine-tuned control over what does and does not get transferred than what Migration Assistant provides.

What to do Before Migration

IMPORTANT: If you aren’t comfortable with how the Mac OS X file system works and how to perform the steps below, seek assistance. This procedure requires strong Intermediate to Advanced Mac User skills.

On the Old Mac

There are several steps you will want to take on the old Mac before you begin. Deauthorize any activated (tethered) software that you have installed (e.g., Adobe Creative Suite, QuarkXPress, Pro Tools, etc.). This will allow you to reauthorize your software on the new machine after a migration, or revert back and reauthorize the old machine if things don’t work out.

If you’re not going to keep using the old machine for your music or video playback once you make the move, also deauthorize your computer in iTunes so that you don’t lose one system from your limit of five.  This is done from the Store menu, select Deauthorize Computer…

It’s always a good idea to backup your data before the transfer.  If you’ve been having any disk problems I also highly recommend running DiskWarrior on the old drive before migration.

Connecting to the New Mac

If you haven’t already done so, login to or create the user account on the new Mac that you will be migrating the old data into.  It’s usually a good idea to create a new account for this purpose, or at least create a spare admin account on the destination machine which you can use in case something goes awry during the migration.

If both your Macs have FireWire you can use FireWire Target Disk Mode to connect the old machine to the new.  Reboot the old Mac and hold down the T key at startup. When the FireWire logo appears on screen, connect a FireWire cable between the two Macs. The old Mac’s hard drive should mount on the desktop of the new Mac as an external FireWire drive.

You can also use File Sharing over the local network to connect the two machines; turn on File Sharing on the old Mac, access it via ethernet or WiFi on the new Mac, then mount the entire hard disk (rather than just the home folder) on the desktop as a remote server.

If neither of these are options, you can copy your old Mac data onto an external USB2 or FireWire hard drive, a Flash drive, or (if you’re feeling ambitious or desperate) remove the hard drive from the old Mac and put it into an external enclosure for connection to the new machine.

What Needs to be Moved

(1) All User Documents

From the old Mac’s home directory (your user folder, known as ~ in UNIX parlance), copy the contents of the Desktop, Documents, Movies, Music, Pictures and Sites folders (aka ~/Desktop, ~/Documents, etc.) Don’t move the folders themselves, but rather copy all items from the old folders to the same respective folders on the new Mac.

Home FolderAlso, move any additional user created folders which may exist in the home directory or at the top level of the old hard drive (known as / in UNIX parlance). If the system once ran Mac OS 9 (or earlier) some data may exist in a top level Documents folder or other custom directories.

Moving the user data may take a considerable amount of time, especially if there are lots of pictures, music or movie files involved.  Photo libraries, home movies and “adult media” collections take up lots of drive space. If not everything is required some pruning here can definitely speed up the process.

If you find you don’t have access to a folder – it is marked with a red Do Not Enter badge – you’ve run into a permissions issue. If you’re using a FireWire or USB connection, one quick solution is to select the source drive in the Finder, do a Get Info (Command-I), authenticate by clicking the lock, then check the option to Ignore ownership on this volume.

Ignore Ownership on this Volume

If that’s not an option or it doesn’t work, you can do a Get Info on each folder and adjust Sharing and Permissions to give everyone Read & Write access.

(2) Applications (A Mixed Bag)

Next move all third-party, non-Apple software that’s inside the Applications folder (/Applications), along with any program folders at the root level of the hard drive (put these into the Applications folder on the destination machine). Copy anything you have purchased, downloaded or that otherwise didn’t come installed with the original system – Microsoft Office, Filemaker, web browsers, graphics programs, games, etc..

Do not replace any Apple software in the Applications folder that exists on both Macs – Safari, Mail, iCal, Address Book, etc.. Whatever Apple software programs are on the destination machine are the best to start with; just move the non-Apple software, then use Software Update to patch your system as needed. Exceptions are the Apple iWork suite (Keynote, Pages and Numbers) and the venerable AppleWorks, these are safe to copy over.

If your new Mac does not contain the iLife Suite (iTunes, iPhoto, iMovie, iDVD, iWeb and GarageBand) you should reinstall these apps from an iLife installation CD or DVD. Some iLife apps can be easily migrated (iTunes, iMovie HD, old revs of iPhoto), others cannot. With the exception of iTunes, which can be freely downloaded, I’ve found it’s best to reinstall this package rather than migrate.

The same applies to Apple’s Pro Applications (Final Cut Pro, Aperture, Logic, etc.) – reinstall these from the original media or downloaded installers. This is usually best practice even when running Migration Assistant.

If you were running Mac OS 9 or Classic on your old Mac, there will be top level folders named Applications (Mac OS 9) and System Folder.  If you are moving to an Intel Mac or any Macintosh running Mac OS X 10.5 “Leopard”, Classic isn’t supported and these folders don’t need to be moved. If you are transferring to a PowerPC Mac running Mac OS X 10.4 “Tiger” or earlier and still need Classic mode – don’t laugh, some people are still using this – copy these items from the old Mac to the root level of the new drive.

(3) Preferences and Application Support Files

The key remaining components of a successful migration are Preferences and Application Support files. There are several locations where these items are stored. If you are in doubt about moving a preference or other item, err on the safe side and don’t move it on the first pass.  You can always copy it later if needed.

Top Level Library

The following items are in the Top Level Library folder on the old hard disk (e.g., /Library):

  • from /Library, copy folders for non-Apple applications
  • from /Library/Application Support, copy folders for non-Apple applications
  • from /Library/Fonts, copy all unique items (don’t replace existing fonts on the new Mac)
  • from /Library/StartupItems, copy all items for the apps you still wish to use
  • from /Library/PreferencePanes, copy all items
  • from /Library/Preferences, copy all non-Apple items

User LibraryThe following items are in the User Library inside your Home Folder (e.g., ~/Library):

  • from ~/Library, copy folders for non-Apple applications
  • from ~/Library, copy the Mail and Mail Downloads folders
  • from ~/Library, copy the Safari folder
  • from ~/Library, copy the Calendars folder (if present)
  • from ~/Library/Application Support, copy folders for non-Apple applications
  • from ~/Library/Application Support, copy the AddressBook folder
  • from ~/Library/Application Support, copy the iCal folder (if present)
  • from ~/Library/Fonts, copy all items
  • from ~/Library/StartupItems, copy all items for the apps you still wish to use
  • from ~/Library/PreferencePanes, copy all items
  • from ~/Library/Preferences, copy all non-Apple items

Also copy any preferences for the following Apple apps: Mail, iCal, Address Book, Safari, iTunes, iPhoto, iMovie, iDVD, iWeb, GarageBand, Keynote, Pages, Numbers, Final Cut Pro, Aperture, or Logic.

Wrapping It Up

Move all items to the same locations on the new Mac as on the old. Once everything is copied restart the new Mac, then launch each application to make sure it works and verify your user data is present. You will need to reauthorize any activated (tethered) software upon first launch – you should have an activation waiting online from the deauthorize process you performed before the migration. You will also need to authorize iTunes to play any protected music or video files purchased through the iTunes Store.

Some applications, particularly complex professional software with multiple components (Adobe, Quark, etc.) may have problems running after a migration of this nature. To fix this you can sometimes download an installation/migration fix from the developer.  If not, reinstall the application from your original disks or downloaded installers.

Keychain Considerations

You will need to re-enter the passwords for some applications and web sites after performing a manual migration. The keychain file where these items are stored was deliberately not moved in this process to prevent possible account corruption. If you’ve forgotten some passwords you can use the Keychain Utility (located inside /Applications/Utilities) to view the contents of your old user keychain.

The keychain file can be found on the old drive at: ~/Library/Keychains/login.keychain

[An earlier version of this article was previously published in the Adam’s Apple column on Low End Mac.]