Chat now with support
Chat with Support

On Demand Migration for Email Current - User Guide

Introduction Preparing Migrations Test and Pilot Migrations Configuring and Running Migrations Post Migration Third Party Assessments and Certifications Glossary

G Suite

On Demand Migration for Email connects to the URL http://www.google.com/a/example.com (example.com is from the Google Domain setting above). If that page exists as a Google domain, the next step is to connect to the G Suite server using the OAuth 2 protocol.

Error Description/Resolution
Any message saying an exception occurred because of an “invalid grant”, “invalid request”, or “400 bad request error”.

Each scope URL gives ODME access to a different type of data. ODME checks that each scope has been granted when validating the connection. Note: All scopes need to be added for validation to succeed, even if the options to migrate certain item types are disabled.

Make sure that the test mailbox used for validation exists. Confirm that the client name and API scopes have been set correctly in the Google Admin console. (The Connections screen shows instructions on doing this after you have signed into G Suite with a super admin account.)

Unable to connect to the Google Contacts API.

The test mailbox does not exist, the API scopes are not set correctly, or network issues are preventing ODME from reaching G Suite.

Make sure that the test mailbox used for validation exists. Confirm that the client name and API scopes have been set correctly in the Google Admin console. (The Connections screen shows instructions on doing this after you have signed into G Suite with a super admin account.)

Unable to connect to the Google Calendar API. The test mailbox does not exist, the API scopes are not set correctly, or network issues are preventing ODME from reaching GSuite. Make sure that the test mailbox used for validation exists. Confirm that the client name and API scopes have been set correctly in the Google Admin console. (The Connections screen shows instructions on doing this after you have signed into G Suite with a super admin account.)
Invalid Mailbox (Unable to retrieve folders)

The test mailbox does not exist or does not have IMAP access enabled, the API scopes are not set correctly, or network issues are preventing ODME from reaching G Suite.

Make sure that the test mailbox used for validation exists and has IMAP access enabled. Confirm that the client name and API scopes have been set correctly in the Google Admin console.

Sun ONE/iPlanet

Error Description/Resolution
The test mailbox doesn't exist. You may see the following error when you test the connection: There was a problem testing your connection. Please try again. Verify that the mailbox name does exist in SunONE/iPlanet and that you have spelled the name correctly.
Server name is incorrect, or firewall is blocking access.

You may see the following error when you test the connection:

Failed to connect sunone.example.com IMAP server.

Check that your server name is spelled correctly and that your firewall is open to the On Demand Email Migration for Email IP addresses to port 7191. To obtain the current IP addresses, open the About box from the ODME home page:

Microsoft Exchange 2007/2010/2013/2016/2019

On Demand Migration for Email uses Exchange Web Services (EWS) to connect to your on premises server from the cloud. To validate your server settings, the application connects to your Exchange server using port 443 (https) or port 80 (http) and the administrator credentials you provided in the server configuration.

If you enter a Server URL value that does contain http:// or https://, https:// will be prepended to the URL. It is recommended that you use the servername, but if you require http:// access, you should enter http://servername as the value for Server URL.

After the validation routine has connected to your Exchange server it opens the mailbox that you specified.

Problem Description/Resolution
Firewall blocking access

Your firewall is blocking the On Demand Migration for Email application. To ensure your data can be migrated, open the appropriate port for the On Demand Migration for Email application to connect to your server. To obtain the current IP addresses, open the About box from the ODME home page:

Migration administrator account doesn't have sufficient rights, or test mailbox doesn't exist

You may see one of the following errors when you test the connection:

Invalid Mailbox (Unable to retrieve folders).

Invalid Mailbox (Unable to retrieve folders). The Autodiscover service returned an error.

When this happens make sure your administrator account has been configured as described in the section, Microsoft Exchange 2007/2010/2013/2016/2019. Also verify that your test mailbox exists, and your spelling is correct.

WebDAV API access is not configured on the source Exchange Server 2007

In this case, you may get the following error:

Cannot create a CPUU switch message. Reason: Cannot connect to the mailbox <mailbox name> using the Web Distributed Authoring and Versioning (WebDAV) protocol. Verify that WebDAV is configured and enabled on Exchange server.

If this error occurs, make sure that the WebDAV API access is turned on and properly configured on your source Exchange Server 2007. For more details, please refer the Updating Outlook Client Profiles section.

Microsoft Office 365

When entering connection properties for Office 365, it is recommended that you select the Use auto-discovery option for your server. Entering the Server Name manually may cause errors when migrating many mailboxes.

Error Description/Resolution
Migration administrator account doesn't have sufficient rights, or test mailbox doesn't exist

You may see one of the following errors when you test the connection:

Invalid Mailbox (Unable to retrieve folders).

Invalid Mailbox (Unable to retrieve folders). The Autodiscover service returned an error.

When this happens make sure your administrator account has been configured as described in the section, Microsoft Office 365. Also verify that your test mailbox exists, and your spelling is correct.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating