The MigrationWiz Assessment Tool

The MigrationWiz Assessment tool is available for migration projects for the following scenarios:

  • Mailbox migration projects with G Suite (IMAP), G Suite (Gmail API), Google Drive, or Google Shared Drive as the Source. The Destination can be any supported Destination type.
  • It is most commonly used for mailbox migrations, but is supported for document migrations as well. 

Performing an assessment before any Google migration is highly recommended to estimate the number of required licenses because:

  • In Google migrations, email messages may have been assigned several labels. When migrating to Office 365, multi-labeled email messages result in a separate copy under each corresponding Exchange folder, which increases the storage consumption.

The assessment tool will scan each mailbox and determine the total size of the mailbox and the count of the folders in the mailbox. This is what will be included in the assessment report. It does not provide information on the number of items (i.e., Mail, Contact and Calendar). Please refer to the section below for more information on how to read the assessment report.

To use the tool:

  1. Create the MigrationWiz project, either mailbox or document migration project, depending upon your Source requirements.
  2. Enable Oauth2.0 authentication. For guidance, see Enable access to G Suite using OAuth 2.0.
    When setting up your MigrationWiz project, it is very important to checkmark the box labeledUse Administrator Login, and enter the customer domain name, under the Your Domains field.
    • Important: If you do not do this step, then an email will be sent to all users, requesting their credentials, as part of the assessment.
    • If this step is completed, then users will not receive an email as part of the assessment, which is the strongly recommended approach to follow.
    • G Suite mailbox migration projects require the BitTitan client ID to be granted access to the scopes included in the Knowledge Base article referenced above (and here: Enable access to G Suite using OAuth 2.0).
    • Google Drive document migration projects require the BitTitan client ID to be granted access to the scopes included in the Knowledge Base article referenced above, plus API access needs to be enabled.
  3. Add Users.
    In order to run an assessment, the specified Destination mailboxes and/or OneDrive for Business accounts must be fully provisioned. If the Office 365 licenses cannot be assigned to all the Users at that stage of the migration, at least one (1) license needs to be assigned to a single User. The email address for that single User must be specified for all Destination email addresses in the Users.csv to be imported into the MigrationWiz project, with the Office 365 global admin credentials enabled. When it is time start the migration, all Destination email addresses can be bulk edited by running a script, or by deleting and reimporting the Users.csv file with the correct Destination email addresses.
    • Select the Users that need assessment. You may select all users.
  4. Click on Start.
  5. From the drop-down list, select Assessment.
  6. Select the items to be included in the assessment.
  7. Click on the Start Assessment button.
  8. Once complete, the status will change to "Assessment Complete".
  9. Now click on the Up arrow at the top of the MigrationWiz dashboard to return to the top level. This will show the list of MigrationWiz projects.
  10. From this level, click on the pie chart.
  11. Click OK to receive an email with the project statistics.
    • The sender of this email will be: and the subject header will be: Migration Statistics for Project: "your project name".
    • This email will contain three (3) .zip file attachments. Unzip the attachment with the name:
    • Once unzipped, open the file named ProjectStats.csv.
    • The total size of the mailbox and the count of the folders are reflected in the columns labeled "Mailbox Size (bytes)" and "Folder Count" respectively. The column is labeled "Mailbox Size (bytes)" even if the project is a project type other than a Mailbox migration.
    • You can ignore the other columns which are only populated after the project items have migrated.
    • Convert this number to GB by dividing this number by 1024*1024*1024.
    • Now you can calculate the number of licenses per user.

The size calculations may be different from those that are reported in the Google Admin portal. Some possible reasons for this are:

The MigrationWiz Assessment tool will index the entire Source data, and then convert it to the Destination format. The size calculations will be based on the converted data.

If migrating from G Suite to Office 365, and converting labels to folders (which is the default, and recommended selection), then the size calculation will take into account the fact that labels need to be converted to folders on Office 365. This can result in an increase in size for the mailbox, at the Destination.

If you have date filters under the MigrationWiz project Advanced Options, then the MigrationWiz assessment will take this into account, too. This means that if you have a date filter to migrate just the last 30 days of data, then the assessment will be calculating how much data is in the Source Google Drive accounts for ONLY the last 30 days.

Was this article helpful?
1 out of 4 found this helpful