Refresh email addresses
To perform a successful migration with CodeTwo Office 365 Migration you need to, at least, connect to your source and target servers, select mailboxes that you want to migrate and match them with mailboxes residing on your target server. However, each time the email addresses of these mailboxes are changed on your source or target server, you need to modify them also in the program. To do so, you can use the Refresh email addresses option.
The Refresh email addresses option is primarily used in:
- cutover migration, as part of the post-migration activities, after switching domains and changing MX records
- staged migration, during the second migration stage
in order to perform delta migration and migrate any new or remaining data from the source server.
Before you attempt to refresh email addresses, you first need to reconfigure the connection to the server on which the change was made (for example, the source and/or target domain has been switched or transferred as a part of the migration process). Learn more
Follow the links below to learn more about:
- refreshing email addresses
- analyzing the email addresses refresh status
- refreshing email addresses when migrating mailboxes by using a CSV file (e.g. for hosted Exchange migrations)
- refreshing email addresses for IMAP migrations
How to refresh email addresses
- Go to Jobs tab.
- From the mailboxes list (Fig. 1.), select mailboxes whose email addresses were changed. Press Ctrl to select mailboxes one by one, Ctrl+Shift to select multiple rows, or Ctrl+A to select all mailboxes.
Fig. 1. The list of mailboxes on the Jobs tab.
- Click the Refresh email addresses button on the top menu.
The refreshing process will start automatically. When finished, you will see the results window (Fig. 2.).
Fig. 2. The window showing the results of refreshing email addresses.
You can now either close this window or open a report containing detailed information on this process. You can check which exact email addresses were refreshed successfully, which were not changed, which were not refreshed at all, etc.
Analyzing the results after refreshing email addresses
Below you will find all the possible results of using the Refresh email addresses option, different for source and target mailboxes. Learn more about each potential outcome and find out how to troubleshoot problems with mailboxes whose email addresses could not be updated.
Results for source mailboxes
- Refreshed – the number of mailboxes whose email addresses were changed on the source server and successfully refreshed in the program.
- Not changed – the number of mailboxes whose email addresses were not changed on the source server.
- Not refreshed - missing mailboxes – the number of mailboxes that were not refreshed because they could not be found on the source server. You will get this result if, for example, these mailboxes were deleted from your source server. Once you restart the program or edit the migration job, the migration entries for these mailboxes will be removed.
Results for target mailboxes
- Refreshed – the number of mailboxes whose email addresses were changed on the target server and successfully refreshed in the program.
- Not changed – the number of mailboxes whose email addresses were not changed on the target server.
- Not refreshed - addresses entered manually – the number of mailboxes that were not refreshed because there were entered manually during the mailbox matching step. Make sure these addresses still exist on your target server and match them manually with the source mailboxes.
- Not refreshed - mailboxes not created yet – the number of mailboxes that were not refreshed because they have not yet been created by the program on the target server. Make sure to reconfigure the mailboxes creation settings if the domain on your target server has been changed.
- Not refreshed - missing mailboxes – the number of mailboxes that were not refreshed because they could not be found on the target server. If you want to migrate the source mailboxes that were matched to these target mailboxes, you need to rematch them with other, existing mailboxes on the target server.
Refreshing email addresses when migrating mailboxes by using a CSV file
The Refresh email addresses option is not available if CodeTwo Office 365 Migration is installed outside the source Exchange server domain, e.g. when migrating from a hosted Exchange server. If you want to refresh email addresses (e.g. you changed a domain on your source server), you can do so manually by following the steps below.
First, edit your migration job, go to the Mailboxes step and re-import a CSV file with the same mailbox IDs but updated mailbox email addresses (Source mailbox email addresses and/or Target mailbox email addresses). Thanks to that, the updated data will be applied in a correct way and no duplicate entries will be created on the target server when you resume the migration process.
Next, reconfigure your source and/or target server connections, e.g. if the primary SMTP address of the admin account used to configure the source server connection has changed or if you changed the domain on the target server.
Finally, click Run delta migration to continue with your migration or to migrate new items that appeared on the source server during the domain change/transfer process.
Refreshing email addresses for IMAP migrations
When migrating from an IMAP server, the Refresh email addresses option is not available. It is also not possible to refresh email addresses for source mailboxes once you have changed the domain on your source server. In such a case, you need to create a new migration job.
However, if the email addresses have been changed only on the target server, you can refresh them manually. To do so, reconfigure the target server connection and rematch the source and target mailboxes.