Data Recovery Blog

How to Troubleshoot IMAP mailbox migration issues?

Read time 7 min

Check this guide to know all troubleshooting measures to handle the issues in migrating IMAP mailboxes to any destination.

The most common method of IMAP migration in Office 365 Admin Center often throws errors while performing the migration. We are going to discuss some most common errors encountered during the complex migration process. We also and suggest some easy troubleshooting solutions.

Common Issues with IMAP Mailboxes Migration

Troubleshooting Solutions

We will go through the troubleshooting solutions in all the situations above.

Migration Batch Issues When It Gets Started

First, try resuming or starting the created migration batch again by clicking on the play icon after selecting that particular migration batch. Click Yes to confirm starting the migration. If it runs, then also it can result in different issues for which we are going to discuss troubleshooting solutions now.

Duplicate emails

It happens with the migration procedure forgets to include the Gmail folder under the Exclude folders section. It is possible to rectify the situation by performing two actions.

The mailbox is full

It is an error saying, The mailbox is full. Please free up some space so that the email can be downloaded.This error generally occurs when the storage limit for Microsoft 365 mailbox is exceeded. It happens due to duplicate emails.

Users can try deleting the existing migration batch by navigating to recipients>migration, selecting the existing migration batch, clicking the Stop option, removing the labels from emails as done earlier, and deleting duplicate emails and Gmail folder from the Microsoft 365 mailbox.

Also, make sure to remove labels from emails before migration and exclude the Gmail folder while migrating it to the cloud destination.

Trouble while signing in to the account

After starting the migration batch, users may encounter the error “We had trouble signing in to this account. Confirm that you are using the correct user name and password.” It generally happens when the CSV file used for the migration includes incorrect usernames and passwords for IMAP accounts.

Users can either provide correct passwords against the accounts in the CSV file or use the administrator credentials with required access rights (Full Access/Receive As) to all user mailboxes in that account. For example – a user name “x” can get the entry in the CSV file like this.

EmailAddress,UserName,Password

usera@example.com,contoso/mailadmin/userx,P@ssw0rd

If the above details are already correct, check if the IMAP mailbox exists or not by visiting the recipients>mailboxes location in the Exchange Admin.

Also, it is required that the IMAP access for user mailboxes to be migrated is enabled via IMAP settings in the application (like Gmail) in order to run the migration batch successfully.

A recipient wasn’t found for user@exmaple.com on the target

This error can be rectified by the user if he creates a new user mailbox within the target Microsoft 365 account using the mentioned proxy address and try starting the migration batch again.

If it does not solve your problem, check the CSV file for the IMAP migration first column, i.e., EmailAddress, for correct entries with a proxy address for the target Microsoft 365 account mailbox. Then, restart the migration batch and check if migration runs smoothly.

Migration Batch Issues When It Does Not Get Start

If you have attempted to start the migration batch, but it does not get started rather throw errors, then you need to perform some different troubleshooting solutions.

Batch <name>already exists

It is a common error if you have selected the same name as the existing migration batch. Hence, you need to either create a migration batch with a different name or delete the existing migration batch by navigating to recipients>migration in the Exchange Admin Center, selecting the existing batch, and then clicking the Delete option to remove it. Then, you can create a new migration batch with the same name and proceed with the migration.

Errors with CSV files

Some common CSV errors responsible for the issue in starting the IMAP migration batch along with troubleshooting solutions are –

The CSV file contains more than 50,000 rows – This is the rows limit on the CSV file prepared for migration. So, it is suggested to use multiple files or batches for more than 50,000 users’ migration.

Column <column name> is missing from the CSV file – If any of the columns from the standard CSV file format – (EmailAddress,UserName,Password) is missing, then this error occurs. So, check your CSV file and add the required details for the missing column, retry the migration batch starting.

Upload file can’t be empty – It is a horrible mistake made by the user where they forget to add the right CSV file or enter the empty file without required details. Hence, a recheck is needed, and required details must be provided to the CSV file before its addition.

Row X has the wrong number of columns – The error is encountered when any column information is missing in one or more than one row of the CSV file. It is a common mistake but can be corrected by editing and adding the CSV file again.

Connection to the server could not be completed

This error occurs during the specification of the IMAP server’s FQDN in the following scenarios. Also, take the related troubleshooting solution for each one of them.

While creating a migration batch with no endpoints – Here is the process to specify the public FQDN correctly.

  1. Log in to the Exchange Admin Center of the account used for migration (with administrator credentials).
  2. Go to recipients>migration.
  3. Click on the plus icon to select the Migrate to Exchange Online
  4. Choose IMAP migration and click Next.
  5. Then click the Choose file option, browse, and add the CSV file. Click next.
  6. Then enter the public and resolvable FQDN (example.com) and click next to proceed with creating and running the migration batch finally.

 While creating the migration batch with the existing endpoint, follow this process to determine the public FQDN.

  1. On the Exchange Admin Center, go to recipients>migration.
  2. Click the 3 dots or More option and then select the Migration endpoints
  3. Select the migration endpoint
  4. Then check the FQDN of the IMAP Serer at the bottom of the page.
  5. Recreate the migration endpoint if it is incorrect or not publicly resolvable.

The connection to the server <servername.example.com> timed out

It happens when –

Mailbox migration is running too slow

Please find the below pointers to deal with the situation where your mailboxes under migration are moving at a very slow pace.

So, now we have apt troubleshooting solutions for IMAP mailbox migration to the cloud platform but dealing with such a number of issues while performing native IMAP mailbox migration requires immense patience. So, we would like to suggest the most efficient and automated professional tool known as Kernel IMAP to Office 365 that performs precise migration of IMAP Server mailboxes with a lot of options and smart GUI.

Conclusion

During the migration of IMAP mailboxes to Office 365 using manual methods, email users may face a lot of issues. Though there are some fixes for all these issues, they may consume a lot of time and effort. Also, these methods are technically complex. So, it is recommended to use a professional solution for IMAP to Office 365 migrations.