This is the complete onboarding task flow for exporting either regular mailboxes or in-place archive mailboxes to PST (Outlook Data Fil) files.
For this scenario, the Destination is a Bring Your Own storage container on Azure. This will hold all of the PST files after the mailboxes have been exported to PST. The export of the selected mailboxes will be saved, in the Azure container, as one or more PST files per user mailbox. BitTitan Azure Storage is only available as a Source endpoint for PST migration.
A new PST will be created for every 10GB of data in a mailbox. This increases the export speed and leads to efficiency improvements.
First migration?
We’ve created a guide on scoping, planning, and managing the migration process for your use. If this is your first migration, we recommend reading this guide carefully.
MigrationWiz
MigrationWiz is a migration tool, not a syncing tool. If changes are made at the source after migration, they will not sync to the destination, nor will changes made at the destination sync to the source. We do not have “live” monitoring of changes (as with a sync agent) and we cannot handle scenarios such as conflict resolution without user interaction.
MigrationWiz supports the capability to share migration projects across a Workgroup. When the Project Sharing feature is turned on, all Agents besides those who are Inactive can view all migrations projects.
Prerequisites
Licensing
Purchase and apply User Migration Bundle licenses for all the users being migrated. For this migration type, we suggest the User Migration Bundle. For questions on licensing, visit MigrationWiz Licenses.
- User Migration Bundle Licenses have unlimited data available per license.
- User Migration Bundle Licenses are applied to the customer's users and expire 12 months after their purchase date.
- Document, Personal Archive, and DeploymentPro projects are all included when using User Migration Bundle Licenses.
- This license type must be applied manually.
To use your license by following the next steps:
- Purchase Licenses.
- Create a Customer.
- Apply Licenses.
- Review Considerations.
Purchase licenses by following the steps below:
- Sign in to your BitTitan account.
- In the top navigation bar, click Purchase.
- Click the Select button and choose User Migration Bundle licenses.
- Enter the number of licenses you want to purchase. Click Buy Now.
- Enter a Billing address if applicable.
- Click Next.
- Review the Order Summary and enter a payment method.
- Click Place Your Order.
Create Customer on MSPComplete by performing these steps:
- Click the Add button in the top navigation bar
- Click the Add Customer button on the All Customers page
- Select the appropriate workgroup in the left navigation pane and click All Customers.
- Click Add Customer.
- Enter the new customer’s information in the Add Customer form. Primary Email Domain and Company Name are required. The rest are optional.
- Click Save.
- Repeat steps 1 through 4 for each customer you want to add.
Perform these steps on MSPComplete:
- Select the correct workgroup on the top of the left navigation pane.
Important
This is the workgroup which the customer and migration projects were created under. Your account must be part of the workgroup if the project was not created under your account. - Click Customers on the left navigation pane.
- Click the customer that employs the user to whom you want to use the User Migration Bundle license.
- Click the Users tab at the top of the page.
- Apply the license to the users by checking the box to the left of their emails.
- Click the Apply User Migration Bundle License button at the top of the page.
Tip
We recommend adding users to the Customer page with the vanity domain. Then apply the User Migration Bundle Licenses, before editing to show the .onmicrosoft domain, if the .onmicrosoft domain will be used for the migration. - Click Confirm if at least one unassigned User Migration Bundle license is available for each selected user.
Important
If there are no User Migration Bundle licenses currently available to be assigned and your role in the workgroup is Manager or higher, the form that appears provides all the necessary information and will walk you through the steps of purchasing User Migration Bundle licenses.
Licenses are released once payment has been received:
- Licenses are available immediately upon payment if you purchase via credit card.
- If you purchase via wire transfer (100+ licenses), the licenses will be available once payment is received and accepted.
- We do not accept purchase orders because of processing overhead.
In both cases, you will be notified by email that payment has been accepted and licenses are available in your account upon notification.
For more information on licensing, including coupon redemption and other licensing types, see our Licensing FAQ.
Limitations
Please review the following limitations before performing this type of migration.
- We are not able to support migrations with two-factor or multifactor authentication.
- The maximum file size for migration through MigrationWiz varies by migration type and environment, but may never exceed 60GB.
Prepare the Source Environment
If your Source server is running Exchange version 2003, or Small Business Server (SBS), refer to the Prepare the Source Environment section in the On-Premises Exchange 2003 to Office 365 Migration Guide.
- If your migration requires it, set up an administrator account for the migration.
- If your Source is Exchange, EWS must be working on the Source Exchange server. Read the How do I verify if my OWA URL is correct? article for more information.
- Test mailbox access. Read the Verify mailbox accessibility using EWS article for more information.
- Disable the Exchange throttling policy during migration. Read the How do I disable the throttling policy on Exchange? article for more information.
Important
- This is only relevant for Exchange 2010+. Exchange versions 2007 and earlier do not have throttling policies.
- Follow the instructions under Option 1 in the How do I disable the throttling policy on Exchange? article to disable throttling for just the admin account, rather for than all users.
How Do I Set the Azure Location?
During migration, set the Advanced Option, under Support> Support Options, PSTCustomEndpointSuffix=(azure URI choice below) to enable migration servers to locate PST files in that location.
Important
The Azure URI needs to be changed to one of the following values:- core.cloudapi.de (Germany)
- core.usgovcloudapi.net (government)
Important
It is important to understand that if Germany is chosen, data will still securely leave the country during migration because compute resources are outside of the country.Prepare the Destination Environment
- Estimate Azure storage costs. This step is optional but is useful in providing the customer with upfront storage costs ahead of time.
- Buy an Azure subscription, or use the free one-month trial (option only viable for very small migration).
- Create an Azure storage account:
- Visit the Azure portal.
- Click Storage accounts.
- Click Create.
- Select the Subscription and create a new Resource group or use a current one.
- Name the Storage account.
- For Region, select a geographic region for the storage account.
- For Performance, select Standard general-purpose V2 account.
- In the Redundancy field, select Locally-redundant storage (LRS).
- Click the Review button.
- When the validation ends, click the Create button.
- Once the deployment of the storage account is complete, click the Go to resource button or open up the home page for the new storage account.
- In the Security + networking section of the left sidebar, click on Access Keys.
- On a notepad, copy the Storage account name and the key1 and save them.
- Create an Azure BLOB container. Take note of the name of the BLOB to be entered in the Bucket Name field in the project Advanced Options.
MigrationWiz Steps
Create a Mailbox Migration Project
Create the Mailbox Migration project or Archive Migration project (depending on whether you are exporting regular or in-place archive mailboxes to PST). Read the How do I create a new migration project? article for more information.
- Create the Mailbox Migration Project or In-Place Archive Project
- Select the customer, or create a new one.
Important
If you are migrating a mixture of regular mailboxes and in-place archive mailboxes, create one mailbox migration project and one archive project. - Create source and destination endpoints.
Endpoints
Endpoints are created through MigrationWiz. If you select an existing endpoint from the dropdown, it will only show ten endpoints. If you have more than ten, you may need to search it.
Consider that endpoint search is case and character-specific. For example, Cust0mer will not show up if the search is customer. We recommend keeping a list of endpoints you have created, along with any unique spellings or capitalization you may have used.
Create your Endpoints
Please review the following tabs to create your destination and source endpoints.
Create the Source and Destination endpoints.
Create your source endpoint by following the next steps:
- Click Source Settings.
- Select New.
- Enter endpoint name.
- For the endpoint type, select Exchange Server 2003+.
- Enter the EWS URL.
- Click the Provide Credentials radio button.
- Enter the admin account credentials for the account set up under the "Prepare the Source Environment" section above.
- Click Add.
Create your destination endpoint by following the next steps:
- Click Destination Settings.
- Select New.
- Enter endpoint name.
- For endpoint type, select PST.
- Enter the Storage Account Name.
- Enter the Access Key.
Important
Only numbers and lowercase letters are allowed for the Azure Storage Account Name for the destination endpoint. If you enter an upper case letter, your migration will fail. - Select the Region closest to your Destination Tenant from the dropdown menu.
- Click Save Project.
Region of Destination Tenant
The Region of Destination Tenant feature optimizes the migration performance and speed by choosing the region closest to the destination tenant. MigrationWiz displays a dropdown that allows you to select the destination region when configuring your destination endpoint.
Tip
You can find the region of your destination tenant directly in the Microsoft Entra admin center by going to Identity > Overview > Properties, and using the Country or region or the Data location.
For more information on this topic, review this article.
Warning
If you do not complete this field you will not be able to save your project and the “This field cannot be left blank.” error will appear.Add Accounts
Using Bulk Add, add the accounts, also referred to as "items", that will be migrated to the project:
- Sign in to your MigrationWiz account.
- Select the Project for which you want to perform the bulk import.
- Click Add.
- Click Bulk Add.
- Follow the instructions on the page.
Please consider the following information when adding your accounts.
- The Source will be the SMTP address for each mailbox.
- The Destination will be the name that you want for the PST file. It must include .pst at the end of each entry. A good format to follow is to name each file after the username that the PST file will belong to, e.g., user1.pst, user2.pst.
Advanced Options
The following advanced options show you some options that will help you to perform o complete a migration.
Source/Destination Tab
-
Bucket Name = migrationwiz
- This field can be left as it is if you did not create your own Azure container when preparing your Destination environment. The PST files will be exported to a container named "migrationwiz".
- If you created an Azure container with a different name, this entry must be changed to match the name of your container.
Run Verify Credentials
- Open the Project containing items you wish to validate.
- Select the items you wish to validate.
- Click on the Start button in your dashboard.
- Select Verify Credentials from the drop-down list.
Once complete, the results of the verification will be shown in the Status section.
Start migration
- Select the users.
- Click the Start button from the top.
- Select Full Migration.
- Click Start Migration.
Run Retry Errors
Look through the user list and click any red "failed migration" errors. Review the information and act accordingly.
If problems persist, contact Support.
Post Migration
Optional (does not apply to Microsoft storage): Delete the Azure blob container that was created during the upload to Azure. This will prevent incurring post-migration Azure costs for these containers. Be careful to only delete the container that was created for this migration project.