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

Zimbra

Zimbra

Error Description/Resolution
Invalid Mailbox (Unable to retrieve folders): A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond 192.101.144.66:993 Incorrect IMAP address/port
Invalid Mailbox (Unable to retrieve folders): AUTHENTICATE failed Incorrect IMAP admin username/password
Invalid Mailbox (Unable to retrieve folders): Failed to connect to server 192.101.144.65 on admin port 7072 as user root. Unable to connect to the remote server Incorrect SOAP address/admin port
Invalid Mailbox (Unable to retrieve folders): Unable to connect to the remote server Incorrect SOAP port
Invalid Mailbox (Unable to retrieve folders): Failed to connect to server 192.101.144.65 on admin port 7071 as user root2. Exception of type 'Zimbra.Client.ZimbraException' was thrown. Incorrect SOAP username/password
Invalid Mailbox (Unable to retrieve folders): Failed to connect to server 192.101.144.65 on admin port 7071 as user root. The underlying connection was closed: An unexpected error occurred on a receive Incorrect SOAP Admin or Port SSL setting
Invalid Mailbox (Unable to retrieve folders): Tried to read a line. Only '' received. Incorrect IMAP SSL setting

Adding Mailboxes

Adding Mailboxes

After connecting to your source and target email service, the next step is to list the mailboxes you want to migrate. This is done in the Mailboxes tab.

 

Note: If you haven’t already done so, set up the mailbox accounts in the target email service. On Demand Migration for Email does not create target mailboxes during a migration. Also, you cannot add mailboxes until you have successfully connected to your source and target email service.

You can add the mailboxes you want to migrate manually, or in the case of a large migration, you can import a TSV file which lists each mailbox. If you selected the option Use end-user credentials when connecting to either the source or target email service, you must specify the passwords for each mailbox.

Be aware that if you import TSV file, this will overwrite any mailboxes that have already been added, whether manually or through a previously imported TSV file.

Supported mailbox types

This table lists mailbox types migrated by On Demand Migration for Email.

Source User mailbox Shared mailbox Resource mailbox* Group mailbox
G Suite      
Exchange 2007/2010/2013/2016/2019
*Migration from Exchange 2010, 2013, 2016, and 2019
 
Office 365  
Sun ONE/iPlanet      
Zimbra      
GroupWise      
IMAP      
POP/Hotmail      

Resource mailboxes for Exchange and Office 365 are used for reserving and coordinating rooms and equipment.

Dealing with large mailboxes

Mailboxes that added to a migration plan are migrated in parallel as described in Connecting to Email Services. However, contents of each individual mailbox are migrated subsequently, item by item. That may cause decreased migration performance for large mailboxes.

To make the migration faster for a large mailbox, you can split the mailbox's contents into several parts by time when message is created or received and then migrate each part in a separate migration plan.

To do that, take the following steps:

  1. Approximately estimate the time period of messages within the mailbox by finding the oldest message and the newest.
  2. Split the estimated time period into several shorter time intervals. Note that each time interval must have a one-day overlap with the neighbor time intervals to avoid data loss.
  3. For each time interval create a separate migration plan. Note that each migration plan should use its own pair of source and target administrative accounts.
  4. Add the mailbox to all of these migration plans.
  5. On the Options page of each migration plan under Date Range select Choose Date Range and specify the corresponding time interval.

 

Important: In case of migration to Office 365, it is not recommended to have more than 4 migration plans processing the same mailbox in parallel due to Office 365 throttling limitations. Otherwise, the The server cannot service this request right now. Try again later. Waiting 5.00 minutes before resuming errors may repeatedly occur decreasing an overall migration speed.

Adding Mailboxes Manually

Adding Mailboxes Manually

If you are migrating a relatively small number of mailboxes, you can add the mailboxes manually. If you selected the option Use end-user credentials when connecting to the source or target email service, you must also specify the password for each mailbox.

For the source IMAP servers that support Simple Authentication and Security Layer (SASL), like the Dovecot IMAP server, ODME can use the Administrator credentials of the IMAP server to access the user accounts. To add a user mailbox in this scenario, enter [user account name]*[administrator account name] in the Source Mailbox field, and provide the Administrator account password in the Source Password field.

To add mailboxes manually:

  1. In the Source Mailbox field, enter the name of the source mailbox.
  2. If you selected the option Use end-user credentials when connecting to the source email service, click in the Source Password field and enter the password for the source mailbox.
  3. In the Target Mailbox field, enter the name of the target mailbox.
  4. If you selected the option Use end-user credentials when connecting to the target email service, click in the Target Password field and enter the password for the target mailbox.
  5. Click the Checkmark icon to add the mailbox.
  6. Click Add Mailbox to activate a new row.
  7. Repeat steps 1 through 6 for each mailbox you want to add.
  8. When finished, click Save to stay on the Mailboxes tab, or click Save and Continue to move to the Options tab.

Note: If for any reason you want to undo the changes you made since the last time you saved, click Discard Changes.

Adding Mailboxes through a TSV File

Adding Mailboxes through a TSV File

Be aware that if you import TSV file, this will overwrite any mailboxes that have already been added, whether manually or through a previously imported TSV file.

To add mailboxes through a TSV file:

  1. Create a text file which lists each mailbox to be migrated on a separate line beneath a “Source Mailbox” header.

For example:

Source Mailbox

psmith@example.com

bjones@example.com

bill.jones@example.com

 

Note: Be aware of the following:

  • For GroupWise, mailbox names cannot be nicknames or full SMTP addresses. For example, “admin” is valid, but “admin@domain.com” is invalid.
  • For G Suite, the full primary email address for each G Suite mailbox is required

If a source mailbox is being migrated to a target mailbox with a different name, add a second header named “Target Mailbox” and list each target mailbox that is named different than its corresponding source mailbox

Source Mailbox

Target Mailbox

psmith@example.com

Patrick_Smith

# Paula_Smith source mailbox will be migrated to Paula_Smith on the target

 

Paula_Smith@example.com

bjones@example.com

Bill_Jones

Bill_Jones@example.com

 

The format of each entry varies depending on the source or target server type, as shown in the following examples:

Exchange 2007/2010/2013/2016/2019 and Office 365 Source and Target

The import file entry for an Exchange 2007/2010/2013/2016/2019 and Office 365 source and target mailboxes should be the full SMTP address. If, however, the domain name for the SMTP address matches the domain name on the admin credential, then it can be omitted.

Source Mailbox

Target Mailbox

psmith@example.com

 

bjones@example.com

Bill.Jones@example.com

IMAP source and Office 365 Target

If the MAP server supports the Simple Authentication and Security Layer (SASL), user can provide a single Administrator credentials with user mailboxes in a TSV file. ODME will use the Administrator credentials to migrate user mailboxes, if you select the Use end-user credential option in the target.

Source Mailbox

Source Password Target Mailbox Target Password

psmnith@example.com*Admin user name

Admin Password1 psmith@office365.com Password1

bjones@example.com*Admin user name

Admin Password2 bjones@office365.com Password2

Specifying Mailbox Passwords

If you selected the option Use end-user credentials when connecting to the source email service, you must specify the password for each mailbox beneath a header named “Source Password.”

Source Mailbox

Target Password

psmnith@hotmail.com

Password1

bjones@hotmail.com

Password2

Likewise, if you selected the option Use end-user credentials when connecting to the target email service, you must specify the password for each mailbox beneath a header named “Target Password.” In this case, your TSV file might look like this (be sure to specify any target mailboxes with different names under the “Target Mailbox” header):

Source Mailbox

Source Password

Target Mailbox

Target Password

psmnith@hotmail.com

Password1

 

Password1

bjones@hotmail.com

Password2

 

Password2

Bill.Jones@hotmail.com

Password3

bjones@example.com

Password3

  1. Click the Mailboxes tab.
  2. Click Import TSV.
  3. In the dialog box, click Select TSV File. Then find and select the TSV file you want to upload.
  4. Click Import.

On Demand Migration for Email imports the file and displays the list of source and target mailboxes. If any entries are improperly formatted, the file will not be imported and you must correct any errors identified. If you need to modify your migration plan, edit your source text file and then re-import. The entire list will be updated to the contents of your text file.

 

Note: For GroupWise, if you receive a “No returned session value Status code: 53507” error, check the import file make sure you are not using nicknames or full SMTP addresses. For example, “admin” is valid, but “admin@domain.com” is invalid.

 

Caution: If you plan on running two different migration plans simultaneously to the same target email service, migrating the same mailbox can result in duplicated data on the target.

  1. When finished, click Save to stay on the Mailboxes tab, or click Save and Continue to move to the Options tab.

If for any reason you want to undo the changes you made since the last time you saved, click Discard Changes.

Related Documents