Skip Ribbon Commands
Skip to main content

Office 365 Group to Office 365 Group Document Migration Guide

Last Update: 12/2/2016 4:14 PM

​​​​Office 365 Group to Office 365 Group Document Migration Guide

Introduction

  • This is the complete onboarding task flow to migrate group files from one Office 365 tenant to another Office 365 tenant.
  • Complete each step in order. Links to corresponding Knowledge Base articles are included.
  • Important: You must create Source and Destination endpoints for every Office 365 Group and individual document migration projects must be created for each group that needs to be migrated.

Prepare the Source Environment

  1. Create an administrator account in Office 365 to be used for the migration, or use the global admin account for the tenant. KB004948
  2. Add the migration administrator account as an owner and a member of the Source group. Read the Manage Group membership in the Office 365 admin center article from Microsoft to learn more.
  3. Make note of the owners and members of the group. You will need this information later when replicating the membership of the Source group at the Destination group.
  4. Identify the storage usage for groups in the​ Office 365 tenant, which helps you to determine the number of document migration licenses to purchase. KB005840

Prepare the Destination Environment

  1. Create an administrator account in Office 365 to be used for the migration, or use the global admin account for the tenant. KB004948
  2. Create the Office 365 Group, if it doesn't already exist. Read the Create and navigate a group article from Microsoft to learn more.
  3. Add the migration administrator account as an owner and a member of the Destination group. Read the Manage Group membership in the Office 365 admin center article from Microsoft to learn more.
  4. Add other owners and members to the group to replicate the membership of the Source group.

MSPComplete Steps

  1. Create the customer. KB005421
  2. Create the Source and Destination endpoints. KB005427
    • For the Source endpoint:
      • Click Endpoints > click Add Endpoint > enter endpoint name > select Office 365 Groups for endpoint type.
      • Enter the URL of the group's document library into the URL field. KB005831
      • Enter the admin account credentials. Note: This should be a global admin account. If creating a separate admin account for the purpose of migration, refer to the Office 365 section in KB004725.
    • For the Destination endpoint:
      • Click Endpoints > click Add Endpoint > enter endpoint name > select Office 365 Groups for endpoint type.
      • Enter the URL of the group's document library into the URL field. KB005831
      • Enter the admin account credentials. Note: This should be a global admin account. If creating a separate admin account for the purpose of migration, refer to the Office 365 section in KB004725.
  3. Purchase licenses. From your MSPComplete dashboard, click Purchase > click Document Migration > select MigrationWiz-Document, and enter the number of licenses you wish to purchase. Note: Check to see if there are bundles available for discounts (e.g., MigrationWiz mailbox and document bundle). KB004647

MigrationWiz Steps

  1. Create the document migration project > select the customer > select the Source endpoint (Office 365 Group) > select the Destination endpoint (Office 365 Group). KB005070
  2. Add "Shared Documents" as the library that will migrate for both the Source and the Destination. KB004842
  3. Set the Project Advanced Options. KB004834
    • Set the value for maximum licenses to consume per item, per pass. The default value is one license per user, which allows up to 10GB to be migrated per user. However, if a user has 28GB of data, the migration will pause at 10GB, and you will have to assign more licenses to the user. The recommended maximum licenses to consume per user for a document migration project is five (5) licenses per user, which allows up to 50GB of data to be migrated per user. The project will only consume the number of licenses for the amount of data migrated. If a user has 28GB of data, then only three out of the five licenses will be consumed, and two licenses will remain. KB004890
      • Under Support/Support Options add:
        • InitializationTimeout=28800000 - This increases the initialization timeout window to eight hours. KB005099
        • FolderLimit=20000 - This increases the maximum number of folders for the migration to 20,000. Large companies might have more than 10,000 folders (the default) to migrate, so we recommend increasing the folder limit to 20,000. KB005557

          Note: There are no spaces on either side of the "=" sign, and the entries are case-sensitive, so pay special attention to the capital letters in the commands above.
  4. Run Verify Credentials. KB004511
  5. Notify users that a migration is occurring. Send email to all users telling them the time and date of the migration. During this time, users should not modify documents in the Office 365 Group because modifications will not be included in the migration.
  6. Perform a full migration pass. Select the users > from the top navigation, click Start from the top, and select Full Migration > click Start Migration. KB004938
    • Under the Select what to migrate section, ensure that only "Mail" is selected before starting the migration.
  7. Click the pie chart icon in the MigrationWiz dashboard to receive an email containing all the project migration statistics. KB004626