Advanced settings and options
CodeTwo Office 365 Migration offers additional options that improve the migration process and let you take control of the mailbox items that will be migrated. These options are available as steps in the migration job wizard or the server connection wizard.
To access the migration job wizard, click Edit on the program's ribbon.
To access the server connection wizard, go to Dashboard and click the cogwheel button located in the upper-right corner of the Defined source/target server connections cards.
The Source mailboxes step allows you to decide which mailboxes should and should not be migrated, using different built-in filters (Fig. 1.). Migration is possible only for mailboxes located within the domain (and its subdomains) under which the program is running.
Every filter can be used either as a condition which includes the mailboxes or as an exception that excludes them. You can, for example, set the program to migrate all the users from an Organizational Unit or exclude a user group from migration. The available filters are:
- All users (default setting) – all the users who have a mailbox.
- Public Folders (default setting) – all public folders. Be aware that the program automatically consumes 25 licenses for public folders migration.
- Active Directory users – chosen Active Directory user or users. If a user has no active mailbox, the program will not allow you to add such a user.
- Active Directory group – all members of an Active Directory group. The program will automatically add only those members who have active mailboxes.
- Email address filter – all the users whose email addresses match a defined filter.
You can use the asterisk (*) sign to list mailboxes whose email addresses match a pattern. For example, *@my-own-company.com will include all the users located under the my-own-company.com domain. You can use several patterns at a time. Simply separate different patterns with the semicolon (;) sign. The example below will include all the users from my-own-company.com and my-own-company.chicago.com.
- Organizational Unit – all members of an Active Directory Organizational Unit. Just like with options above, the program automatically adds only members with an active mailbox.
Please note that the program will include only users that are actually located within the Organizational Unit.
Let us say, you have a Group One located in Miami OU. Group One contains users from both Miami OU and Chicago OU. In such a scenario the program will migrate only those users, who actually exist in the Miami OU.
In the Time filter step of the migration job wizard, you can choose which items will be included in the migration process based on their age (modification date). This option is mainly used for staged migrations. The time filter determines the age of an item depending on the item type. The list below shows which properties are taken into account when defining the item’s age:
- Contacts – Last Modified Date,
- Calendars – End Date,
- Emails – Received Date, then Sent Date, and then Created Date (if the program cannot find the Received Date property, it searches for Sent Date, and so on),
- Tasks – Due Date or, if this property is missing, Last Modified Date,
- Notes – Last Modified Date,
- Journal – End Date.
There are three options to choose from (Fig. 2.):
- Migrate all items regardless of their age – choose this option to migrate every mailbox item.
- Migrate only items older than [exact date] – choose this option to migrate only the items that were modified prior to the selected date. For example, if you select 1 December 2016, every item modified before that date will be migrated.
- Migrate only items not older than [exact date] – choose this option to migrate only those items that were modified on and after the specified date. If you now select 1 December 2016, every item modified on 1 December 2016 up to now will be migrated.
Note that when you decide to migrate items based on their age, the Override the time filter for contact items checkbox (marked by default) will appear (Fig. 3.). Clear this checkbox to apply your custom settings also to contact items.
The Folder filter step lets you decide which folder types will be included in the migration process. This feature is helpful, e.g. if some folders contain a lot of useless items. Such folders can be excluded from the migration to shorten the migration time and save network bandwidth.
If you are configuring an IMAP job, only mail folders can be chosen. This is due to the limitations of the IMAP protocol.
There are two general types of folders that can be managed using the Folder filter option:
- default folders
- special folders
The table below shows the types of default and special folders that can be included in the migration process depending on the type of the source server chosen in the connection wizard:
|Source server type||Default folders||Special folders|
Please note that the contents of Suggested Contacts/Recipient Cache (Contacts type) and RSS (Emails type) special folders will always be migrated, as long as they exist in the mailbox and the corresponding folder type is checked.
In turn, however, some special folders are not available for migration at all - those are i.e. Sync Issues or folders created when putting a mailbox on litigation hold.
*If you choose to migrate Deleted items, the program will migrate only the items present in this folder. Items deleted from this folder (that can be recovered in a particular mailbox by using the Recover Deleted Items feature in Outlook) will not be migrated.
As some of the folders' types are unchecked by default, it means that they will not be included in the migration process unless you mark the corresponding checkbox.
The Junk folder (special folder) is the only folder type that is excluded from migration by default (Fig. 4.). Mark the corresponding checkbox if you want to include this folder in your migration job.
The Advanced settings step of the migration job wizard (Fig. 5.) lets you:
- set the maximum number of concurrent mailbox migrations. In other words, you can decide how many mailboxes should be migrated at the same time;
- set the maximum size of an item to be migrated.
The number of concurrent migrations is limited to 20 to maintain the performance of the migration process. The actual value in this field depends on the job type. For Exchange jobs, the number of simultaneous migration connections is equal to the number of logical processors in your machine. For IMAP jobs, the recommended value is 2. The main bottleneck is usually the upload bandwidth, and in such a case increasing the number of concurrent connections will not directly improve the migration process and may even cause performance loss. You can modify this value on your own, but if you’re configuring a migration job for the first time, we strongly recommend that you leave the default settings. Change the default settings only after you’ve run the migration for some time and found out that the process is too slow. In this case, see also the migration speed article before making any changes.
The option to change the maximum size of migrated items may be used to improve the migration stability. In the case of Exchange source connections via MAPI, you should decrease the maximum size of migrated items if you encounter errors related to insufficient system memory. In the case of other connections, you should decrease the maximum size of migrated items if you encounter errors related to the Exchange data transfer restrictions.
This step allows you to address data transfer limits that may be imposed by the IMAP server. Often, free email providers (e.g. Google) limit how much data can be downloaded via IMAP per hour, day, etc. The number of IMAP sessions per mailbox can be limited too. Those limits, or the so-called throttling, differ between email service providers, so it is impossible to configure the software in one universal way. If you are about to download a significant amount of data via IMAP (a few or more gigabytes), you should check the help website of your mail provider before starting the migration to find out if there are any IMAP throttling policies set server-side. If yes, configure the software to avoid reaching those limits.
You can adjust the following options:
- Max number of IMAP sessions per mailbox – by default, the value is set to 3. This option is limiting the maximum number of concurrent IMAP connections to a single mailbox.
- If a mailbox migration is throttled by the server, restart the mailbox in [h] – by default, the value is set to 1 hour. If the migration of a mailbox has been suspended due to the throttling policy, this value specifies how many hours the application should wait before attempting to continue the migration.
Additionally, by using Max data transfer per mailbox, you can define how many megabytes per hour and gigabyte per day can be migrated. After exceeding those limits, the migration of a mailbox will be suspended and the program will move on to migrating other mailboxes. The default value is 0 (zero) which means there is no limit.
In several places you can import data from a CSV file. The data in the CSV file can be arranged in any order and separated with any delimiter, because the program allows you to easily map the required fields. Depending on how you accessed the Import mailboxes window, different fields are required, e.g. when listing source mailboxes from an IMAP server, you have to provide at least the login (or email address) and the password.
Let us assume that you have an existing IMAP user whose mailbox you want to migrate to a new environment:
Name: Oneida Riddle
The CSV entry (delimited with a semicolon), ready for import in the Source server step of the IMAP connection wizard, would look like this:
Once you select a CSV file listing your mailboxes (or mailbox pairs), a new window will open (Fig. 7.) that allows you to map the data type fields expected by the software with the actual data in your CSV file.
Mapping should be done in three steps:
- Step 1 – CSV file options – used to confirm how the program should read the file provided file:
- Encoding – determines what encoding should be used while reading the file.
- Fields delimiter – specifies a character that separates data fields in the CSV file. Usually, it is a (;), a comma (,) or a tab. There is also an option to select a custom character.
- Text qualifier – lets you choose a pair of characters that indicate the beginning and the end of a single field (e.g. "Oneida Riddle"). The program accepts double quotes (""), single quotes ('') and files with no qualifiers as well.
- If the very first row of the CSV file contains columns descriptions, you can use the First line contains column headers option to ignore it.
- Step 2 – Review your data – used to preview data imported from the CSV file. The application always displays the first 10 rows and shows how the information was mapped according to Step 1.
- Step 3 – Mailbox field mapping – here you can define which field should correspond to which column in the file you are importing (e.g. Login is Column 1). If a field name ends with the asterisk (*) character, it means that it is required.
If all steps are completed correctly, use the Import button to start importing the data into the program. Once the import is complete, you should see a summary of all the potential errors that might have been encountered.