How to use the email migration tool

The migrate company admins and domain admins can use tools 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.

Things to consider before migration

  • Ensure to review and complete preparation before email migration.
  • Migration can be used for IMAP4, IMAP4S, POP3, and POP3S accounts; 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.

Migrating mail via the Control Panel

  1. In the Email section of the Control Panel, click the Email domains tab.
    email_domains.png
  2. Click the domain that you want to modify, and then click the Bulk tools tab.
    bulk_tools.png
  3. Under Operation Type, select Migrate users.
    migrate_users.png
  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]
    If the usernames contain commas, use something else as a delimiter.

  5. Click Submit.
    migration_job.png

Back to top

Migrating mail via the MAC

  1. Log in to the Mail Administration Console (MAC).
  2. In the navigation pane, under Tools, click Migrate.
    2021-04-07_18-07-14.png
  3. Select the New migration tab.
    2021-04-07_18-08-11.png
  4. Complete the following fields, as applicable.
    Job name Enter a unique job name. If this field is left blank, a system-generated numeric name will be used.
    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 The hostname or IP address from which you are migrating mail.
    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.
    Skip Specify 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.
    Translate A 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 an eliminator, such as a colon.
    Users A 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 deliminator.

  5. Click Migrate.
    2021-04-07_18-09-51.png

Additionally, 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.

Back to top

Related articles

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.