Migrate data from PST files
You can use G Suite Migration for Microsoft® Exchange (GSMME) to migrate mail, calendars, and contacts to users’ G Suite accounts from PST files. You can use the command line or the desktop interface for the migration. You can also migrate the PST files directly to Google Vault.
If you decide to migrate directly to Vault, keep in mind that:
- Migrated messages won’t be seen in Gmail.
- Folder information is removed from messages before they’re migrated, so they won’t have labels in Vault.
- You must have Gmail enabled.
- Migration to Vault Former Employee (VFE) licensed users will fail (because Gmail isn't turned on for these users).
Before you begin
- Ensure that you are using a supported version of Microsoft® Outlook®. See System requirements.
- Create a CSV file for users. If you're migrating calendar resources, you should also create a CSV file for calendar resources.
- Next, authorize GSMME for your domain.
- Disable any password protection and allow read and write permission on each PST file.
- Prepare the PST folder structure:
- Set up a top-level folder.
- Within that top-level folder, create an individual folder for each user whose PST files you want to migrate.
- Name the individual folders the same as the primary email addresses in the legacy environment. For example, if your legacy environment email addresses are email@example.com and firstname.lastname@example.org, then name your individual folders email@example.com and firstname.lastname@example.org.
- Place the PST files in the individual folders.
Example:C:\PST (top-level folder)
email@example.com (user folder)
Mail.pst (PST file)
Archive.pst (PST file)
firstname.lastname@example.org (user folder)
Archive.pst (PST file)
Note: When you migrate mail folders, the email is labeled with the PST file name. The message isn't put directly into the user's inbox. (To avoid this, use the command line to migrate and add the
Use the desktop interface to migrate
- Click Start All Programs G Suite Migration G Suite Migration to run GSMME.
- Under Server type, select Exchange.
- Select Specify a folder with PST files and click More
- Navigate to the top-level PST folder (example above) and click Next.
- Complete step 2 (User and domain information) in Migrate data from Exchange using GSMME.
- Complete step 3 (Data to migrate and migration settings) in Migrate data from Exchange using GSMME. If you want to migrate directly to Vault, follow these steps:
- Under Select the data you wish to migrate, check the Email messages box.
- Click Advanced options.
- Check the Migrate to Google Vault box and click OK.
Use the command line to migrate
Use the following commands to migrate using the command line. For details on how to use the command line, see Run GSMME from the command line.
--pst_base_folder="PST top-level folder name"
--filename="filename containing user list"
--service_account_json_path="json file path"
If you want to migrate directly to Vault, use the
--migrate_to_vault command as well.
TroubleshootMessages missing or not migrated with the correct sender or recipient
A PST file might not contain the SMTP address for a message's sender or recipient. Instead, it can have the Exchange X.500 address. This issue can occur if no Global Address List profile is created, or the user has been deleted from the list. To resolve the issue, see Troubleshoot GSMME.
If you’re using an exported or archived PST file, it’s not possible to identify the primary root folder for Calendar and Contacts. All calendars are migrated as “additional calendars” into Google Calendar, instead of a default calendar.
You can avoid this by only migrating email from PST files and using Exchange to migrate calendar and contact data.