This guide covers general information about how document migrations should be prepared for and performed. It is planned to be generalized information for those new to document migrations in MigrationWiz, rather than specific, and should be used in conjunction with your environment and migration guides.
Document migrations function differently from Mailbox migrations as long as environment preparation and advanced options are utilized.
Document Migrations
Performing a Document Migration
Document migrations follow a general basic flow:
- Prepare your source environment (as outlined in your scenario-specific migration guide).
- Prepare your destination environment (as outlined in your scenario-specific migration guide).
- Verify license quantity and apply (if using UMB licenses). [LINK]
- Create a Document migration project (these steps are outlined below).
- Create or apply endpoints [LINK].
- Add users (this, and all following steps, are laid out in the migration guide for your scenario).
- Apply Advanced & Support Options (as directed in your migration guide).
- Verify credentials.
- Notify users.
- Run the migration.
- Retry errors.
- Post-migration steps.
To set up a document migration project, perform the following steps in order:
- Click the Go to My Projects.
- Click the Create Project.
- Create a Document project.
- Click Next Step.
- Enter a Project name and select a Customer.
- Click Next Step.
Advanced Options for Document Migrations
Each scenario-specific migration guide will let you know what options are suggested for that scenario. The following section explains those options in more detail and provides additional context for their use. When in doubt, follow the instructions in your migration guide.
Support Tab
Remove Existing Permissions When Unspecified
- Option Command: RemoveExistingPermissionsWhenUnspecified=1
- Environment(s) & Scenarios: Google Drive to OneDrive for Business; Dropbox (as destination).
- Migration Type(s): Document
- Description: This option resolves any conflict of permission problems during certain document migration projects. This clears existing permissions from the Destination, before adding any new permissions.
Should Convert to Destination Format
- Option Command: ShouldConvertToDestinationFormat=1
-
Environment(s): Google Drive as Destination only.
Important
This option will try to maintain migrated items in Google Format. - Description: This support option takes the source system format and converts it to the destination format.
Map Permission Email by Pairs
- Option Command: MapPermissionEmailByPairsInProject=1
- Environment(s): OneDrive/Google Drive (Destination)
-
Migration Type(s): OneDrive/Google Drive as a destination only.
Important
Permissions generally cannot be migrated unless the prefix of the mail address is the same in the source and the destination. However, choosing Support Option MapPermissionEmailByPairsInProject=1 will allow permissions to be migrated without identical mail addresses. - Description: When OneDrive/Google Drive is the destination, this option can be used to map permissions by pairs in the project. user@domain.com to firstinitial.lastname@domain.com
Increase Initialization Timeout Window
-
Option Commands: InitializationTimeout=X
This option can be adjusted as needed to the following parameters:- Hours:
InitializationTimeout=2 will increase the timeout to 2 hours.
InitializationTimeout=4 will increase the timeout to 4 hours.
InitializationTimeout=8 will increase the timeout to 8 hours. - Milliseconds:
InitializationTimeout=7200000 will increase the timeout to 2 hours.
InitializationTimeout=14400000 will increase the timeout to 4 hours.
InitializationTimeout=28800000 will increase the timeout to 8 hours.
- Hours:
- Environment(s): All
-
Migration Type(s): Document migrations
Important
This value is in hours, up to 100 hours. Values above 100 are in milliseconds. - Description: This option increases the timeout limit to 8 hours.
Rename Conflicting Files
- Option Command: RenameConflictingFiles=1
- Environment(s): OneDrive
- Migration Type(s): Document
- Description: Enables document renaming to resolve conflicts
Document Browsing Mode
-
Option Command: DocumentBrowsingMode=FullCopy
Choose one of the following customizations: FullCopy | Strict (default) - Environment(s): All
- Migration Type(s): Document
- Description: Define the browsing strategy MigrationWiz uses for document scanning. All folders are migrated.
Ignore Conflicting Files
- Option Command: IgnoreConflictingFiles=1
- Environment(s): OneDrive/SharePoint
- Migration Type(s): Document migrations
- Description: Set this value to skip FileAlreadyExists exception in the One Drive (Sharepoint).
Ignore List View Threshold
- Option Command: IgnoreListViewThreshold=1
- Environment(s): All
- Migration Type(s): Document migrations
- Description: Allows the user to continue migration when the list view threshold (> 5000 items) is reached for a specific folder. If the option is not set, an error is logged and migration is halted.
Migrate External User Permissions
- Option Command: MigrateExternalUserPermissions=1
- Environment(s): Google Drive, Dropbox
- Migration Type(s): Document Migrations
- Description: Enable external user permission fallback.
Remove Existing Permissions When Unspecified
- Option Command: RemoveExistingPermissionsWhenUnspecified=1
- Environment(s): All
- Migration Type(s): Document
- Description: This option resolves any conflict of permission problems during certain document migration projects by clearing existing permissions from the Destination before adding any new permissions.
OneDrive Import/Export URL
Important
Note that this is a suite of options. Some or all may apply to your migration. For more information, contact Support.-
Option Commands
- OneDriveProExportUrl=https://tenant-my.sharepoint.com - Provides an override option for domain, tenant, and extension identification in OneDrive migrations for the source(export). By default, OneDrivePro attempts to detect this information. In some cases, there may be ambiguity that requires the customer or support to be specific.
- OneDriveProExportAdminUrl=https://myadmin.sharepoint.com - This is needed when the admin URL is not in one of the standard formats and thus can't be derived from the OneDriveProExportUrl.
- OneDriveProImportUrl=https://tenant-my.sharepoint.com - Provides an override option for domain, tenant, and extension identification in OneDrive migrations for the destination (import).
- OneDriveProImportAdminUrl=https://myadmin.sharepoint.com - Provides an override option for domain, tenant, and extension identification in OneDrive migrations for the destination (import).
- Environment(s): OneDrive only
-
Migration Type(s): OneDrive as source or destination only
Important
The URLs listed in the command are examples only. Replace with your environment URL. - Description: Add these options if the administrative credentials cannot verify the source or destination target OneDrive containers.
Government OneDrive/Office 365 Tenant
Note that this is a suite of options. Some or all may apply to your migration. For more information, contact Support.
-
Option Command:
To export from Germany, China, or US Government instances, enter:
- OneDriveProExportEnvironment, Then select one of the following:
- AzureGermanyCloud
- AzureChinaCloud
- AzureUSGovernment
To import to Germany, China, or US Government instances, enter:
- OneDriveProImportEnvironment, then select one of the following:
- AzureGermanyCloud
- AzureChinaCloud
- AzureUSGovernment
- Environment(s): OneDrive/Office 365 tenants only
-
Migration Type(s): Document migrations
Important
This option must be used for all migrations involving China, Germany, or US Government instances. - Description: This option targets the needed URI to migrate data on these specialized Azure instances.
Warning
If this option is not used for the listed migration instances, the following error will appear:Your migration failed to check source credentials. Authentication Error: Bad username or password. You must call the Connect-MsolService cmdlet before calling any other cmdlets.
If this error appears, navigate back to the Project Setup and enter the appropriate option and environment before proceeding with your migration.
Run Retry
Please consider the following points before performing this action.
- Run Retry Errors is a migration action that imports new data to the specified transfer limit.
Important
The transfer limit is configured in the Advanced Options. - You can only perform this action in migrations when their status is Completed. If the migration status is "Transfer limit Reached" or "Not Started", you cannot perform this action.
- The completed migration must contain at least one error item before performing Run Retry Errors.
- Run Retry Errors consumes the same license as a full migration does.
- OneDriveProExportEnvironment, Then select one of the following: