GWMMO release notes

Fixed issues where calendar exceptions to recurring events from an old G Suite Sync profile weren't being correctly migrated.

Fixed an issue where GSMMO was prevented from authorizing access to the Google Account when Microsoft Edge was set as the default browser.

Fixed an issue that caused GSMMO to fail at the start when a Click-To-Run edition of Outlook 2016 was installed, due to an internal error. The failure can also occur when trying to migrate data after creating a new G Suite Sync profile.

Fixed an issue that caused the truncation of MIME headers when reporting mail message migration errors in the trace log.

Fixed an issue with MAPI to MIME conversion that prevented messages being migrated if they had internationalized email addresses.

Google Apps Migration for Microsoft Outlook has a new name, G Suite Migration for Microsoft Outlook (GSMMO), and a new logo.

Better logging on enterprise MSI installer to help diagnose compatibility issues.

Better logging on Gmail label creation failures and labels cache refresh that helps with diagnosing email migration issues.

Fixed a crash that occurred in some cases when using a Click-To-Run edition of Outlook 2016.

Fixed several issues caused by Gmail label creation conflicts which prevented messages from being migrated, for example if the letter case is different ("Customers" in Outlook vs. "customers" in Gmail).

Fixed an issue which caused a server timeout error to be reported as a (local) network timeout.

Fixed an issue where Calendar exceptions to recurring events weren't being migrated for the invited user.

Fixed an issue where migration would fail if the username starts with a Windows reserved name and a period (for example, "con.user@example.com").

Fixed an issue where GSMMO wouldn't refresh the OAuth token until it had expired (causing unnecessary retries and authentication error messages being written to the log) when using a Service Account.

Updated OAuth2 endpoints. See Troubleshoot network traffic issues to see if your firewall/proxy needs changes.

Fixed an issue that caused the migration to keep retrying in case of authorization issues instead of reporting failure to the user.

Fixed an issue where calendar exceptions to recurring events weren't being migrated for the invited users.

Fixed an issue where migrated email messages may include unexpected characters at the end of the email.

Fixed an issue where a message with an X500 sender address that couldn't be resolved to a valid SMTP address migrates with the From header of "unknown@domain."

Fixed an issue where messages failed to migrate to Gmail if they were in folders with leading or trailing spaces, or there were two or more consecutive embedded spaces in the folder name.

Fixed an issue where messages from a PST file containing invalid values in MAPI properties were converted to MIME messages with invalid From headers and then rejected by the Gmail API.

OAuth token is now refreshed before it expires, resulting in fewer 401 errors during large migrations.

Improved back-off behavior when the server returns an HTTP status 429 (Too Many Requests) response.

Message bodies are no longer written to the trace log when an email upload fails.

Added the quotaUser argument to all API requests to make sure the API quota is counted per user and not per IP.

Fixed an issue where messages were rejected by the Gmail API if the From header did not contain a valid SMTP address.

Failed API requests are now retried correctly using increasing intervals (exponential back-off).

Messages greater than 5Mb were failing to migrate.

The migration of secondary calendars was not working correctly. This issue has been fixed.

Removed the deprecated clientlogin command line option --google_password.

Removed the command option --noenable_calendar_fanout as this is the default behavior since moving to the Calendar v3 API.

Issue: Client migrations failed if three consecutive 503 backoff responses were received. The client would enter a “throttled” state which quickly exhausted the remaining retry requests and failed the migration with the “Migration failed due to network error” message.

This issue has been fixed. The client now properly performs exponential backoff when receiving 503 requests. The client retries up to 10 times increasing the sleep period exponentially before retrying a request. If a successful event occurs, the retry and sleep times are reset.

Added new command line option --emapi_sleep_time. This setting allows you to increase the number of milliseconds that GSMMO pauses between each email migration API request.

Deleted items were being migrated into the Gmail inbox and not trash. Deleted items now are properly migrated to trash.

Changed the required minimum wait between email migration API requests from 700ms to 1000ms.

GAMMO now uses the latest Email Migration API (version 2).

This release fixes the integration with Google Apps Sync for Microsoft Outlook. There was an issue that prevented existing Outlook profiles/PSTs from being imported when creating a new G Suite Sync profile.

GAMMO calendar migrations now uses the latest Google Calendar API (version 3).

Calendar migrations now recognize more time zones.

GAMMO can now get the sender's email address from the message's internet headers even if it's missing from the sender field in Outlook.

This release fixes the following issues:

• Removed ClientLogin API support, as the API is deprecated. This means that users can now only authenticate using the browser with OAuth.
• Removed the incorrect request to copy the authorization code during the authorization flow. The prompt now only asks the user to switch back to the application after authorizing access.
• Fixed an issue where re-migrating secondary calendars would fail if the user had deleted the calendar in G Suite.
• Fixed issue where the -noenable_label_prefixes command line option was not respected when using the GUI.
• The command line option -noenable_label_prefixes was renamed to -noenable_label_prefix to be consistent with Google Apps Migration for Microsoft Exchange (GAMME).
• Fixed a crash that would happen if the password dialog was cancelled when performing a PST migration.

GAMMO now supports Outlook 2013 (32-bit and 64-bit), and runs on Windows 8 in addition to previously-supported operating systems.

GAMMO is now available in 26 new languages!

GAMMO is now available in 26 languages (in addition to English). Its documentation is available in many of these languages, too.

GAMMO now matches whichever language the user has defined for Microsoft Outlook, if that language is one that we support. If not, it matches the user's Windows default language, if supported. Otherwise it opens in English.

GAMMO documentation is available in these languages, too. To view documentation in your language, visit the following links and choose your language from the pop-up list at the bottom of the page.

Help for users
Help for administrators

GAMMO now supports SSO via 3-legged OAuth

GAMMO now supports using 3-legged OAuth for migrating users' mail, contacts, and calendar data to G Suite. When running the migration utility, users can now sign in to their G Suite account through a single sign-on (SSO) system—using their current service's login credentials, rather than their G Suite credentials.

3-legged OAuth is also more secure since users can explicitly grant access to their account and then revoke it any time.

The new version also supports a new command-line flag to disable calendar fanouts, creating events only for the user whose data is being migrated—without adding the event to calendars of other attendees. This new flag is useful when performing test migrations.