staze / migrator

Let users migrate themselves!

Thunderbolt Data Migration

A script that automates data transfer from one mac to another easily. This is intended to be used by non-technical individuals with minimal hassle on Macs managed by Jamf Pro.

Requirements

• jamfHelper is used to display some of the the user dialogs while the script is running.
• The jamf binary and a PPPC profile are used to run the finalizer script with full disk access.
• Both scripts will need to be set up as Jamf Pro policies as described in the "usage" section.

Usage

• Update the migratorUserPassword to the same value.
• Upload both scripts to Jamf Pro.
• Create a policy, scoped appropriately, set to run at the custom event thunderboltDataMigrationFinalize, available on an ongoing basis, and add the thunderbolt_data_migration_finalize.sh script to this policy.
• Create a policy, scoped appropriately, available in Self Service on an ongoing basis, and add the thunderbolt_data_migration.sh script to this policy.

Testing

By default the script is set to not perform the rsync action when testing="true".

# Set to true while testing, the rsync will be bypassed and nothing permanent will done to this Mac
# Set to false when used in production
testing="true"  # (true|false)

Workflow

1. User receives a dialog box with simple instructions to start up their old machine in Target Disk Mode and connect it to their new Mac via Thunderbolt cable (top-most image)
2. If a user successfully connects their Target Disk Mode booted Mac, the Thunderbolt volume will be detected automatically and move on.
3. In the event that a Target Disk Mode booted Mac is already connected before the script begins, the user has an option to select the Thunderbolt volume themselves.
4. If a user exists on the old Mac that matches the logged in username on the new Mac, the script will automatically assume that old user's home folder is the source of our transfer.
5. If no user exists on the old Mac that matches the logged in username on the new Mac, the user will get an option to select from a list of user home folders to determine the source of our transfer.
6. The script then determines if there is enough space to transfer from the source home folder to the new Mac and continues if space requirements are met.
7. A full screen jamfHelper dialog is then displayed while the old home folder data is transferred to the logged in user's home folder on the new Mac (using rsync) (image below).
8. A migration user is created with a Secure Token.
9. The current user is logged out.
10. If a user with the name of the migrated user exists on the new computer, it is removed.
11. The files are moved into place.
12. The user to migrated is created by the migrator user with a Secure Token.
13. The migrator user and supporting files are removed from the computer.