How to use the email migration tool

The Migrate tool can be used by Company admins and Domain admins to download mail from remote servers into existing email accounts. It preserves subfolders and keeps the original dates of the email messages. If a message already exists in the destination account, it does not duplicate it.

Migrate can be used for IMAP4, IMAP4S, POP3 and POP3S; however, for POP3 accounts, only mail that is in the Inbox is migrated.

We recommend that you migrate no more than 500 mailboxes at a time; if you need to migrate more than 500, you should do it in multiple batches.

 



Wistia video thumbnail

Migrating mail via the Control Panel

1. In the Email section of the Control Panel, click the Email Domains tab.

2. Click the domain that you want to modify and then click the Bulk Tools tab.

3. Under Operation Type, select Migrate Users.

4. Complete the fields as follows:

Migrate Users

  • Job Name—Enter a unique job name. If this field is left blank, a system-generated numeric name will be used.

Source Server

  • Server Hostname—The hostname or IP address from which you are migrating mail.
  • Server Protocol—From the drop-down list, choose the mail retrieval protocol that will be used to migrate the user messages.
    If you choose Auto, the system will migrate the Inbox via POP3, and other folders via IMAP4. If you have POP users, you should choose Auto.
    The Inbox will migrate more quickly with IMAP4 than POP3, so we recommend that you submit the POP3 users in one job using Auto and submit the other users in another job using IMAP4.
  • Server Ports—The ports to which you will be connecting.
    For Auto, the ports are POP3, POP3s, IMAP4, and IMAP4s. Set this value to 0 to disable the protocol; for the others, just use a single port.
    To add additional ports, click the plus sign at the bottom of the list.

Folders

  • Folders to Skip—Specify any folders that you want to ignore while migrating.
    Note:This section is optional, and doesn't apply to POP3 users as folders are not migrated from POP3.
  • Translate Folder Name—Enter the source and destination folder names, if they are not the same.To display additional fields, click the plus sign at the bottom of the list.

Users

  • List of users and passwords—Enter a delimited list of the source and destination users and passwords. Use the format: source_username,source_password,local_username
  • Example: user@example.com,password1234,user
  • Note: The local username is everything before @domain.tld, so if the local user is user@example.com, simply put user. 
  • If the usernames contain commas, use something else as a delimiter.

5. Click Save.

Migrating mail via the MAC

To bulk migrate mail in the MAC

1. Log in to the Mail Administration Console (MAC).
For more information, see "What is the MAC?"

2. In the navigation pane, under Tools, click Migrate.

3. Click the New Migration tab.

4. Complete the following fields, as applicable.

\ \
FieldExplanation
Job NameEnter a unique job name. If this field is left blank, a system-generated numeric name will be used.
ProtocolFrom the drop-down list, choose the mail retrieval protocol that will be used to migrate the user messages.

 If you choose auto, the system will migrate the Inbox via POP3, and other folders via IMAP4. If you have POP users, you should choose auto

 The INBOX will migrate more quickly with IMAP4 than POP3, so we recommend that you submit the POP3 users in one job using auto and submit the other users in another job using IMAP4.
ServerThe hostname or ip address from which you are migrating mail.
PortsThe ports to which you will be connecting.
 For auto, the ports are POP3, POP3s, IMAP4, and IMAP4s. Set this value to 0 to disable the protocol; for the others, just use a single port.
SkipSpecify any folders that you want to ignore while migrating. Enter each one on a separate line.

Note: This field is optional, and doesn't apply to POP3 users as folders are not migrated from POP3.
TranslateA list of the source and destination folder names, if they are not the same.

 Put each corresponding pair on a separate line, and separate the source and the destination names by commas (source folder,destination folder). If your folder names contain commas, use something else as a deliminator such as a colon.
UsersA list of source and destination users and passwords.

 Use the format username,password[,local_username]
  • username—The source username.
  • password—The source user's password.
  • local_username—The destination username. If not provided, "username" will be used.
If the usernames contain commas, use something else as a deliminator.

5. Click Migrate.
You can click the Results tab to view the migration process as it happens. Color coding allows you to see each account as it is processed and see whether the migration was successful. You do not have to stay on this page while the migration is running.

Advanced migrations

You can migrate multiple destination accounts into a single local account; however, you must do each migration in a different batch. This allows you to consolidate mail from two or more accounts into a single local account.

Viewing migrations in the Control Panel

To view information about migrations

1. From the User menu located at the top right corner of the window, click Bulk Actions.

 

Viewing migrations in the Control Panel

 

2. Click the job that you want to view to see in more detail.
The job is displayed in an Email Migration Details window. You can see the accounts that were migrated, their status, the amount of data that was transferred, and the number and total size of the email messages that were migrated for each account.

3. To view the migration details for a particular account, click the account name. (Accounts that were not successfully migrated display Failed in the Status column. )
A window appears that displays the details for that account, including the names of the folders and number and size of the messages that were migrated to each folder.
To save or print this information, click Download Log at the bottom of the window.

4. Click Close to close this window.

Viewing migrations in the MAC

To view information about migrations

1. Log in to the Mail Administration Console (MAC).
For more information, see "What is the MAC?"

2. In the navigation pane, under Tools, click Migrate.

3. Click the History tab to display a list of all the migration jobs that have completed and, if applicable, the migration that is currently underway.

4. Click the job that you want to view to see in more detail.
The job is displayed in the Results tab. You can see the accounts that were migrated, their status, the amount of data that was transferred, and the number and total size of the email messages that were migrated for each account.

5. To view the migration details for a particular account, click the account name. (Accounts that were not successfully migrated display error in the State column. )
A pop-up window appears that displays the details for that account, including the names of the folders and number and size of the messages that were migrated to each folder.
To save or print this information, click Download Log at the bottom of the pop-up window.
To close the pop-up window, click theXin the upper left corner.

Was this article helpful? 0 out of 0 found this helpful
Have more questions? Submit a request