When you created a project, you defined the Source, the Destination, and the items that need to be migrated. This can be mailboxes, documents, archives, etc. The MigrationWiz project also has Advanced Option features that will allow you to customize the project even more.
These are broken down into General Options and Advanced Options. Under Advanced Options, you may also use Support Options to further configure your project.
To access your options:
- Click Edit Project.
- Click Advanced Options.
General Options
These options are basic-level configurations.
- Max. concurrent migrations: This parameter defines how many migrations to allow simultaneously. Submit as many migrations as you like, we will only allow this number of migrations to be active concurrently.
- Max. errors of migration: When an error occurs during the migration, we check to see if the number of errors that we receive reaches this threshold. If it does, we call the migration a failure. Otherwise, we keep on going.
- Send successful migration email notifications: Choose who to notify when a migration has been executed successfully.
- Send failed migration email notifications to: Choose who to notify when a migration fails.
- Customize Notification Email: Customize email for success, failure, and request for credentials. Use certain keywords as codes for certain data. OAuth 2.0 does not use customized email; it will only use the default.
You can use Markdown syntax to format your email.
The filtering tabs allow for specific ranges to be migrated. You can choose the By Date or By Folder filtering options.
- Specify the earliest date to migrate: Migrates everything newer than this date.
- Specify the latest date to migrate: Migrates everything older than this date. Any date filters that have been set here will be overridden by the date filters that are set under Start/Pre-Stage migration.
- Filter folders (RegEx): Define Regular Expressions commands to filter the folder to be migrated. This option is found under the By Folder tab.
- Licensing allows you to set up a maximum number of licenses to use per item.
- Number of days after which this project will be auto-deleted if unused: We only keep a project as long as necessary. When a project is not being used, we will delete it after 180 days of inactivity unless otherwise defined in this parameter.
- Log subjects of failed items: When an item was not migrated successfully, retry the errors with this option selected to retrieve the subject and path of the item if it is available.
-
- Settings allow you to establish the time in seconds for the Auto-Refresh Capability by default its value is 180 seconds. For more information about this new feature please review the Welcome to BitTitan article.
Important
The Autorefresh setting works when the toggle button is enabled. To turn on this feature go to the Projects page and toggle the “Enable Page Auto Refresh” button.
Besides, you can also turn this feature on by clicking the autorefresh button () on your project migration page and turn it off by clicking the stop button (
).
Specific Migration Type Options
Mailbox
- Migrate From: Choose between migrating from Mailbox, Archive (only with archive project), or Recoverable items. If migrating from Recoverable items, we recommend you have a litigation hold on.
- For now, the new API Permissions approach does require the Use Impersonation to Authenticate box checked for your O365 endpoints along with the Client secret value that you supplied during the Endpoint creation.
- Migrate From: Choose between migrating to Mailbox, Archive, or Recoverable items. If migrating to Recoverable items, then we recommend that you have litigation holds enabled.
- Destination Mailbox Language
- For now, the new API Permissions approach does require the Use Impersonation to Authenticate box checked for your O365 endpoints along with the Client secret value that you supplied during the Endpoint creation.
Failing Items
Several options can impact whether certain items in a mailbox get migrated. Ensure these options are not blocking the items from migrating.
Check to see if you have one or more of the following enabled under Advanced Options:
- Folder filtering
- Date filtering
- Item type filtering (not migrating calendars, mail, contacts, etc)
Check to see if you have one or more of the following enabled under Advanced Options:
- Folder filtering
- Item type filtering (not migrating calendars, mail, contacts, etc)
Advanced Options
These options will further configure your migration and will allow for special processes.
Bulk Load
The Bulk Load feature is available as part of the Advanced Options for all Mailbox migration projects. This powerful feature allows you to upload up to 40,000 items related to any type of advanced options but you can mostly use it with:
- Recipient mappings.
- Folder mappings.
- User mappings.
- Additional project-specific Support Options for your scenario.
Once you create your project, you can import your support option under the Support tab of the Advanced Options by following the steps below.
- Click Import Multiple Support Options.
- Import your support options.
- Check your imported items.
- Validate and save your changes.
Import Your Support Options
You can import your support options in two ways, no matter which one you choose, consider the following points before importing them:
- Review carefully the support options to import.
- Consider that each line break or space between characters splits the command line, e.g.:
If you add theExample =1support option, it will be imported asExample
=1
Keep in mind that if you want to import your support options via file, you can prepare a .TXT file beforehand. Any other format file is not supported.
To select your file:
- Click Browse.
- Choose your file.
- Click Import Multiple Support Options.
Besides, you can copy and paste your support options into the edit text box. To do so, follow the steps below:
- Copy the support options from the file you prepared.
- Paste it in the editable text box.
- Click Import Multiple Support Options.
Check your Imported Items
MigrationWiz offers powerful tools such as pagination and the search field to help you review your imported items.
MigrationWiz allows you to easily review your imported options by grouping them in a set of options per page, avoiding overwhelming you with a bunch of data.
You can perform the following actions by clicking:
- > You go to the next page.
- < You go backawards.
- << You go to the beginning.
- >> You go to the end.
Important
The number of visible options on each page is configurable, you can set it up in groups of 20, 40, or 60 items.
The search field helps you to find items from your list according to the search term you introduce, it is beneficial when you have a long items list.
Validate and Save Your Changes
Once you review your imported list, it is time to validate it. To do so, click Validate.
This validation shows all the possible issues found in the imported list. MigrationWiz shows and addresses them at the top of the first-page list. Besides, at the bottom of the list find notifications of the validation process. The issues addressed can be related to:
- Duplicate key.
- Value errors.
- Sintax key errors.
After completing a successful validation the following message will be shown at the bottom of the page.
You will notice that the Validate and Save buttons are active and clickable. Click Save to save your imported items, otherwise, you will lose your AO list.
Warning
MigrationWiz will not allow you to save your changes until you solve or erase all the addressed issues from your list.
In case MigrationWiz encounters issues but you think the validation is wrong, at the bottom of the list you will find the following notification:
If you click the notification link, you will be able to save your list. For more information about errors please refer to the Advanced Options Notifications article.
Consider that some fields won't be saved at any chance. For more information about this behavior please review the Validation Notifications section of the Advanced Options Notifications article.
Migrate to Archive
You may perform an archive-to-archive migration simply by setting the Destination Advanced Option within an Archive migration to “Migrate to: Archive”.
You may perform a Mailbox-to-archive migration simply by setting the Edit/Project/Advanced Options (Source/Destination Tab) within a Mailbox migration project to “Migrate to: Archive”.
Recipient Mappings
Recipient mapping is used in mailbox migrations to ensure that the user information maps properly from the Source to the Destination, particularly in cases where the user name or domain name has changed. Below is a table that lays out the properties that are converted for each item to be migrated:
The migrated items for email are the following:
- Sender
- From
- ToRecipients
- CcRecipients
- BccRecipients
The migrated items for appointments are the following:
- SenderEmailAddress
- SentRepresentingEmailAddress
- senderName
- sentRepresentingName
- RequiredAttendees
- Organizer
- OptionalAttendees
- Resources
Recipient mapping is useful in a variety of ways:
- All emails remain responsive to, post-migration, even after a Full (Delta) Migration has occurred when performing a tenant-to-tenant migration while keeping the same domain name; or when changing domain names from Source to Destination.
- Calendar ownership and display name match on the destination when performing a tenant-to-tenant migration, while keeping the same domain name or when changing domain names from Source to Destination.
- A project is required for each Destination domain if you use a recipient mapping while migrating from one Source domain to multiple Destination domains.
Use cases:
- When migrating from Microsoft 365 to Microsoft 365 and keeping the same domain name, recipient mappings must be added to your project, as directed below. This is included in the migration guide for this scenario.
RecipientMapping="@sourcetenant.onmicrosoft.com->@destinationdomain.com"
- When you are migrating over to a new domain name.
- Source domain = Sourcedomain.com
- Destination domain = Destinationdomain.com
- Here is an example - Migrating James@Sourcedomain.com to james@Destinationdomain.com you want to make sure that any entries for james@Sourcedomain.com are renamed to james@Destinationdomain.com during migration.
RecipientMapping="@sourcetenant.onmicrosoft.com->@destinationdomain.com" RecipientMapping="@sourcedomain.com->@destinationdomain.com"
For Large Migrations
A large number of recipient mappings (5,000+) may cause huge migration performance loss. If you are performing a large migration, add UseHashMapRecipientMapping=1. This will address such problems.
Important
You can simplify migrations and avoid errors using a .TXT file for recipient mappings in MigrationWiz. For more information regarding this topic please review the Bulk Load section above.
By opening the collapsible tab, you can compare the use of this Advanced option.
Below is a comparison of project configuration and expected behavior with/without this Advanced Option:
| Project AO COnfigurations | Remark |
|
|
This uses the old way of processing recipient mappings. In this case, 5000 mappings are configured. The migration should expect slowness during migration. |
|
|
Same way of configuring recipient mappings, but with UseHashMapRecipientMapping AO added. This will cause recipient mapping to be handled differently by MigrationWiz and will greatly increase the performance. |
Important
With the new AO, MigrationWiz will identify each “RecipientMapping” item configured as a direct mapping item. Therefore the user has to make sure the mapping is correctly configured with the exact SMTP address, e.g.:
RecipientMapping="user01@source.com->user01@destination.com"
User Prefix Changes
If a user's SMTP address is changing during the migration, Recipient Mapping can be used to ensure that message headers are rewritten with the new prefix. An example is if john.doe@sourcedomain.com was changing to john.doe2@destinationdomain.com. This is common during mergers when migrating data to an existing Microsoft 365 tenant and there are user name conflicts.
The following explains how to add a user prefix Recipient Mappings to your project’s Advanced Options.
Under Support/Support Options:
- Recipient Mapping should be added to each project under Advanced Options/Support Options.
-
- RecipientMapping="john.doe@abc.com->john.doe2@xyz.com"
- Note that Recipient Mapping changes are made according to the order in which the mappings are added to the Support Options. Ensure that the prefix mappings are at the top of the Advanced Options list so they are performed first and not superseded by the action of a domain-level recipient mapping option, e.g., RecipientMapping="@abc.com->@xyz.com". Changes are made based on mappings added from the top down. Therefore, ensure that Recipient Mappings are noted in the correct order you wish them to be performed.
- If you have multiple projects in progress for the same migration (e.g., batches), make sure that these mappings are also in the other project.
- MigrationWiz performs the SMTP rewrite during the migration process. The Source and Destination SMTP addresses for the mailboxes in the project are simply to define the Source and Destination matching. It does not correlate to any changes to email headers during the migration. This is why recipient mapping is mandatory, it ensures responsivity.
Destination Language
The spelling of both 'Calendar' and 'Contacts' must also reflect the language of the folder name at the Destination mailbox, e.g., 'Calendar' will be 'Calendrier' in French and 'Contacts' will 'Contactpersonen' in Dutch.
G Suite (GMail API) Limitations
For ‘GSuite (Gmail API) to GSuite (Gmail API)’ migrations only:
If you want to map multiple source labels into a single label on the destination, then the parent destination label must be created before starting the migration.
Example: If you wish to map three Source labels ('ABC', 'PQR', and 'XYZ') into one parent label ('DestinationLabel') at the destination then you must create the parent label ('DestinationLabel') at the destination mailbox before running the migration.
Enable Auto Remapping for Migrating Users
MigrationWiz has an Advanced Option available which can be added at either the project level or the individual item level, which remaps the Source email address over to the new Destination email address.
To set this, add the following flag under the Support options/support field:
AutoRemapMigratingUser=1
There are a couple of examples where this is useful:
- When migrating over to a new domain name. For example, the Source domain equals Sourcedomain.com but the Destination domain name will become Destinationdomain.com. In this example, if migrating James@Sourcedomain.com to james@Destinationdomain.com , then you want to ensure that any entries for james@Sourcedomain.com are renamed to james@Destinationdomain.com during migration.
- When migrating Source mailboxes over to different Destination mailboxes. For example, james@Sourcedomain.com will migrate over to bob@Destinationdomain.com
Considerations
- MigrationWiz does not auto-remap the migrating user unless this option is set.
- We do not set this by default since we do not want to modify any content during migration, unless our Partners deem this as necessary, by adding this as an Advanced Option.
- An alternative, and preferred, methodology for such remappings is to use the Advanced Option "Recipient Mappings".
Here is a breakdown of the exact functional behavior patterns, when adding this option:
- It will auto-remap:
- The email address (e.g., if the Source domain name is Sourcedomain and the Destination domain name is Destinationdomain, then a mailbox for james will be remapped from james@Sourcedomain.com to james@Destinationdomain.com).
- The display name.
- For:
- Mail (sender + receiver + extra entries such as CC and BCC addresses).
- Calendar (organizer + attendees + extra entries in the calendar item, such as resource rooms, and optional attendees).
- Including:
- ItemAttachment (for any attachment to items).
- Recurrence exception (for calendar recurring meetings).
This Advanced Option has the following limitations:
- We do not support recipient mapping for the actual MIME content, so email mime content-based migrations, such as Zimbra, won't have a remapping for email.
- Further explanation: the MIME content is the information listed under Show Details, for a message, for most email systems.
Here is a breakdown of migration scenarios, to specify which scenarios support this Advanced Option:
- Exchange 2003+ or Microsoft 365 as a Source
Important
Exchange 2003 will migrate using WebDAV. Exchange 2007 can migrate using WebDAV or EWS, Exchange 2010+ will migrate using EWS.
- GoogleApps as a Source
- Limitations: Calendar entries do support this option. Email entries will not support this option because migrations are based on MIME content.
- Zimbra as a Source
- Limitations: Calendar entries do support this option. Email entries will not support this option because migrations are based on MIME content.
- POP as a Source
- IMAP as a Source
Refer to the Help Center article How do I add support options to a project or to a single item? For exact instructions on how to add this support option: AutoRemapMigratingUser=1
Important
The flag is case-sensitive, so be sure to add the flag exactly as indicated above.
Email Notification Customization
You can customize the notification emails that MigrationWiz sends for successful migrations and failed migrations or to verify credentials from the customer’s users.
Complete these steps to customize notification emails in MigrationWiz:
- Sign in to MSPComplete.
- In the MigrationWiz Project Details section of the Getting Started page, click Go To My Projects.
- In the top left corner of the page, select the appropriate workgroup.
- Click the project for which you want to customize email notifications.
- Click Edit Project in the top menu bar and click Advanced Options.
- In the Customize Notification Email section, select one of the following tabs:
- To customize the notification email for a successful migration, select Success and add a checkmark next to Customize "successful migration" email.
- To customize the notification email for a failed migration, select Failed and add a checkmark next to Customize "failed migration" email.
- To customize the notification email for requesting credentials from users, select Credentials and add a checkmark next to the Customize "request credentials" email.
- Type your edits into the Subject or Message text boxes. At this time, the notification emails only support simple text customization.
- The following parameters can be used to customize the notification email even further. These parameters pull information from MigrationWiz and the configured project.
- Click Save when you have finished editing the notification email.
MigrationWiz notification emails originate from support@migrationwiz.com on behalf of your BitTitan user account. This cannot be changed; this feature was designed to prevent potential abuse.
Parameters
Project Type: The type of migration project (mailbox migration, document migration, etc.).
- SourceSystem: The source environment (Hosted Exchange, G Suite, Microsoft 365, etc.).
- SourceIdentifier: The source account (user@domain.com).
- DestinationSystem: The destination environment (Hosted Exchange, G Suite, Microsoft 365, etc.)
- DestinationIdentifier: The destination account (user@domain.com).
- AdminFullName: The full display name of the MigrationWiz administrator (John Doe).
- AdminEmailAddress: The email address of the MigrationWiz administrator (user@domain.com)
- FailureMessage: The error message for a failed migration. (Reason: Your migration failed to check source credentials.). This parameter is recommended only for the failed notification email.
- CredentialsUrl: The URL where users can enter their credentials (https://migrationwiz.bittitan.com/user-credentials/input?i=xxxxxx). This parameter is recommended only for the credential notification email.
Folder Max Length
Even though SharePoint and OneDrive support the folder path length is 400, we have to keep in mind that it's a whole path with extra root folders (SharePoint/OneDrive specific folders and Site URL) which can not be on the source, in case of Google Drive or can be shorter, in case of SharePoint/OneDrive.
Currently, MigrationWiz accepts the ShrinkFoldersMaxLength=n values from 50 to 350, where n is equal to the desired number of characters in the folder path. The base of 50 symbols is to keep space for a filename and specific SharePoint/OneDrive root folder extensions. There is a table with path differences below. Bold text indicates the change in the path from the Source to the Destination.
|
Source |
Changes in the path |
|
Google Drive |
Folder1/Folder2 |
|
Google Drive |
Folder1/Folder2 |
|
SharePoint |
sites/Site/DocLib/Folder1/Folder2 |
|
SharePoint |
sites/Site/DocLib/Folder1/Folder2 |
|
OneDrive |
personal/username_tenantname_onmicrosoft_com/Documents/Folder1/Folder2 |
|
OneDrive |
personal/username_tenantname_onmicrosoft_com/Documents/Folder1/Folder2 |
Troubleshooting
If no Tags Are Present in Advanced Options (AO), by Default, Tags=null Are Added
In case no Tags are present in Advanced Options (AO), by default, Tags=null are added in Support Options. However, projects with Tags=XXXXXX do not have any impact, i.e., no Tags=null if Tags=XXXXXX is already present in AO.