On Demand Migration Current

The Collect OneDrive Statistics Task conducts an assessment of OneDrive related to all accounts in the source tenant and matching accounts in the target tenant: The assessment report provides the following information among others:

The number of items in the OneDrive for each account and the total number of items across all selected accounts where the assessment was possible.
The total size of all the items in the OneDrive for each account and the total size of all items across all selected accounts where the assessment was possible.

Each Collect OneDrive Statistics Task generates events. Events are milestones that a task achieves as it runs. For example, when a Collect OneDrive Statistics Task starts, an event is logged and it appears in the events list. When the number of accounts that are selected for assessment is large, the Collect OneDrive Statistics Task divides the total number of accounts into manageable sets. Each set is called a batch. When a batch of accounts is assessed, another event occurs.

NOTE: Before you proceed, verify that the source tenant accounts have been discovered. For more information see Discovering Accounts

In this topic:

Starting a Collect OneDrive Statistics Task
Reviewing the Collect OneDrive Statistics Task
Reviewing the statistics collected
Reviewing the events for the Collect OneDrive Statistics Task

Starting a Collect OneDrive Statistics Task

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click the OneDrive tile, or click Open from the OneDrive tile to open the Accounts and User Data dashboard.
Select the OneDrive tab and then select List View if not already selected. Then select any account in the list to activate the menu options.
Click Collect Statisticsfrom the Actions ribbon. The New Collect OneDrive Statistics Task wizard opens.
Step 1:Description

NOTE: Statistics are collected from the source tenant by default.
1. Include collection of item count from target OneDrive accounts - select this option to include item count statistics from the target account and generate the Comparison Report.
2. Click Next
Step 2:Schedule
1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
  - Run now - task runs immediately.
  - Run later - task must be started manually.
  - Schedule - task will be started at a future date and time entered in the corresponding calendar field.
2. Click Next.
Step 3: Summary
1. Verify the task specifications as described below:
  1. Name - name of the task. You can specify a custom name. The default name is Collect OneDrive Statistics Task.
  2. Source tenant - name of the tenant where the statistics will be collected.
  3. Target tenant - name of the target tenant in this project.
  4. Collect target statistics - indicates whether you have opted to include item count statistics from the target account.
  5. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

Reviewing the Collect OneDrive Statistics Task

Open the Tasks tab.
Select the Collect OneDrive Statistics Task that you want to review.
In the task details pane that opens, the information presented is as described below:
1. Type - Type of the task. The type is OneDrive Assessment.
2. Created - Date and time when the task was created.
3. Modified - Date and time when the task was last updated.
4. State - State of the task.
5. Last Operation - The action that was most recently performed in this task.
6. Schedule - Date and time when the task started. Now indicates that the task started immediately after the task was created.
7. Accounts (number) - number indicates the count of accounts in the source tenant that are inspected. The values indicate the assessment category of the accounts. The categories are:
  1. Completed - Number of accounts where OneDrive is provisioned and the total size and item count was successfully assessed.
  2. Stopped - Number of accounts where OneDrive could not be assessed because it is neither licensed nor provisioned.
8. Events (number) - The number of events that the task encountered.

Reviewing the statistics collected

Open the Tasks tab.
Select the Collect OneDrive Statistics Task that you want to review.
From the task details pane, click Download Premigration Report. If comparison reports were generated, click Download comparison report.
Download and save the ZIP file to a suitable folder, and extract the report.

Reviewing the events for the Collect OneDrive Statistics Task

Open the Tasks tab.
Select a task named Collect OneDrive Statistics Task that you want to review.
In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
Select an event that you want to review. In the task details pane that opens, the information presented is as described below:
1. Object - name of the account if applicable.
2. Task - name of the task.
3. Time - date and time when the event occurred.
4. Category - type of task. the value is OneDrive Assessment.
5. Summary - a descriptive statement about the event. Notice that the most recent event provides a summary of the assessment across all accounts that could be assessed. The assessment details contain the Total items count and Total file size from the source, and the Total target items count from the target tenant if data is available.

You can migrate OneDrive for discovered and matched accounts with large selection of migration options. These options give you control over the scope of files migrated, permissions, licensing and version management

Recommendation

The OnDemand migration service for OneDrive attempts to provision OneDrive for accounts being migrated if the OneDrive has not been provisioned. You can manually provision the OneDrive before a migration as described below:

Provision OneDrive for accounts in the target tenant that don't have a OneDrive provisioned.
- For a small number of target users, you can manually provision the OneDrive from the Office 365 admin console of the target tenant.
- For a large number of target users, run a PowerShell script to provision the OneDrive. For more details, see https://docs.microsoft.com/en-us/onedrive/pre-provision-accounts
OneDrive must be provisioned at least 24 hours before starting a migration.

In this topic:

Starting a OneDrive Migration Task
Tracking the progress of the migration task
Viewing the report

Starting a OneDrive Migration Task

Log in to Quest On Demand and choose an organization if you have multiple organizations.
From the navigation pane, click Migration to open the My Projects list.
Create a new project or open an existing project.
Click the OneDrive tile, or click Open from the OneDrive tile to open the Accounts and User Data dashboard.
Open the OneDrive tab and verify that the List View has displays the list of user Accounts. See Discovering Accountsif the list is empty.

Select one or more accounts for which you migrate the OneDrive contents. This enables the Migrate OneDrive menu option.

NOTE: To migrate OneDrive for user accounts in a collection

Select the collection from the dropdown menu in the top right corner labeled Select Collection.
Select the accounts to migrate from the collection. To check all accounts, select the check box in the list header.
Proceed to the next step.

Click Migrate OneDrive to open the New OneDrive Migration Task wizard and follow the steps described below. The New OneDrive Migration Task wizard helps you configure the migration options and settings for OneDrive for Business. The default settings are optimized for fast migration. You can change the options and settings to address specific migration needs.

Step 1: Migration Options

Choose a migration action

Overwrite target files - Select this option to overwrite the file in the target tenant if it was previously migrated.
Skip if the target file is the same version or newer - This is the default selection. When this option is selected, the migration service will not migrate a file if the file already exists on the target tenant and has the same or newer version than the file in the source tenant. Select this option to speed up the migration process especially if you are starting multiple migration tasks.

Overwrite if the target file is older or make a copy if the target file is newer - Select this option to overwrite the file in the target tenant if it was previously migrated and the file in the target is an older version, or create a copy of the source file if it was previously migrated and the file in the target is a newer version. When a copy is created in the target it will be renamed. For example, Sample.txt will be renamed to Sample_migration_copy.txt. If the file versions in the source and target are the same, it is skipped.

NOTE: Do not rename a previously migrated file or folder before the migration completes. If you rename a previously migrated file or folder before the migration completes, it may be unexpectedly overwritten even though you select the second or third option. New files or folders are not impacted. The migration service compares both file versions and modified date to determine older or newer files.

[Optional] Files are migrated to the root folder. You can specify an alternate target migration folder
- Relative folder path - specify the relative path to a folder where the OneDrive contents will be migrated.
Click Next.

Step 2: Version Options
1. Specify the scope of file migration
  Each OneDrive file has its own version history and each change to a file is saved with a new version. Select from the following migration options to determine how file versions should be migrated:
  
  NOTE: Only the latest version of frequently updated files such as outlook PST files, database files and log files will be migrated
  - Latest version only - This is the default selection. The most recent version of the file will be migrated. All other versions will be ignored.
  - More versions - Additional versions of a file will be migrated based on the options described below. Large version sets take a significantly long time to migrate.
    - Number of versions - the maximum number of version to migrate. The available choices are: 2, 5, 10, 30, 60, 90 and 365. When you specify the number of versions, additional options can be selected.
    - Latest version and preceding versions - The version count includes the latest version and the preceding versions in chronological order restricted to the Size Limit of the latest version. For example, if you choose to migrate 5 versions, then the most recent version and 4 preceding versions will be migrated as long as the most recent version does not exceed the selected size limit specified.
    - Latest version and daily latest from preceding days - The version count includes the latest version and the latest version from each preceding day restricted to the Size Limit of the latest version. For example, if there are many versions of a file and you choose to migrate 5 versions, then the most recent version and the latest version from each of the 4 preceding days will be migrated as long as the most recent version does not exceed the selected size limit specified.
    - Size limit - This setting is available if the Latest version and preceding versions or the Latest version and daily latest from preceding days option is selected. By default, the size limit is 80 MB. You can configure the size limitation by selecting from one of the possible values in the dropdown list. If the size of the latest file version exceeds the selected size limit, the latest version will be migrated and previous versions will be ignored. If the size of the latest file version does not exceed the selected size limit, then the file and its versions will be migrated based on your selection between Latest version and preceding versions or Latest version and daily latest from preceding days.
  - All Versions - The latest version of the file will be migrated, and all previous versions of the file will be migrated if the latest version does not exceed a specified size limit. This option requires significantly more time to migrate all the versions.
    - Size limit - This setting is available if the All Versions option is selected. By default, the size limit is 80 MB. You can configure the size limitation by selecting from one of the possible values in the dropdown list. If the size of the latest file version exceeds the selected size limit, the latest version will be migrated and previous versions will be ignored. If the size of the latest file version does not exceed the selected size limit, then the file and its versions will be migrated.
2. Click Next.

Step 3: Attribute Options

This step determines how file and folder attributes are migrated and managed by the migration service.

Account display: Select which account will be displayed in the Created by and Modified by properties of migrated content:
- System Account - This is the default selection. The Created by and Modified by properties of the migrated file or folder is displayed as System Account.
- Matching target account - The Created by and Modified by properties of the migrated file or folder is displayed as the target account that was matched with the source account. If the target account cannot be found, the migration service records a warning event and the properties of the migrated file or folder is displayed as System Account.
Permission migration: Select how the sharing permissions will be transferred to the target users:
- Do not migrate permissions - This is the default selection. Permissions associated with the file being migrated will be ignored.
- Update permissions for migrated content - The permissions of files that are migrated will be updated. Some files may be skipped if you selected the Skip if the target file is the same version or newer in the previous step. Sharing Links are not migrated unless Convert Sharing Links permissions to direct permissions is selected.
- Update permissions for all content - All file or folder permissions in the target tenant will be updated whether or not they were migrated if the corresponding file or folder is present in the source tenant. Sharing Links are not migrated unless Convert Sharing Links permissions to direct permissions is selected.
Auto rerun: Select whether to migrate permissions with the Auto rerun task to reduce the task load
- Migrate permissions with the Auto rerun task - the permissions will be migrated with the Auto rerun task after the migration completes.

Permission conversion

Convert Sharing Links permissions to direct permissions - migration is slower with this option select. Select this option to convert Sharing Links permissions of files or folders in the source tenant to direct permissions in the target tenant. Only shared links that were activated by the users or group members (the user or group member clicked on the link to access the file or folder) in the source tenant will be migrated and converted to direct permissions. Users or group members who did not activate a shared link in the source tenant will not get the direct permissions in the target tenant and must re-request permissions from the owner when they access the file or folder in the target tenant.

NOTE:

Users can access their shared content through the Shared With Me view in OneDrive. Some restrictions apply.
Some sharing permissions are not converted if the user has shared the file or folder with more than 30 users. Only 30 users will receive direct permissions from the Sharing Links, while others will not be processed due to a Microsoft limitation.
If a Sharing Link permission is removed on the source file or folder after it is migrated, the links to this file or folder are still visible in the Shared with me and Shared by me views in OneDrive, but the file or folder cannot be accessed.
Group permissions are not displayed in the Shared with me view because Microsoft currently does not support this functionality.
For shared folders, only the top level folder is displayed in the folder tree.
For files and folders that do not exist in target tenant before migration the source permission will always be used.
For files and folders that exist in the target tenant before a migration, the following example describes how file sharing permissions will be managed. The rules are the same for internal and external users as permission holders, or groups (Microsoft 365 group or security group) as permission holders.
For files

If Overwrite target files for selected migration is selected, the source file sharing permission will be used.

If Skip if the target file is the same version or newer is selected, the target file sharing permission will be used.

For folders

If either Overwrite target files for selected migration or Skip if the target file is the same version or newer option is selected, the target sharing permission will be used as a base. Any addition of permissions in the source will be added onto the target.

Click Next

Step 4: Licensing Plan

Set license at the target - select this check box to assign a selected license to migrated mailbox accounts in the target tenant. Clear the check box to skip license assignments for migrated mailbox accounts.
Select the licensing plan - this dropdown list appears if the Set license at target check box is checked. Select the licensing plan from the dropdown list that you want to assign to migrated mailboxes.

Specify how the selected licensing plan will be assigned to the target accounts:

Assign the plan to accounts without Exchange Online option. Licensed users will retain the existing plans - Retain the existing licenses and assign the selected plan only to unlicensed accounts (default). Licensed users will retain the existing plans.
Assign the plan to all accounts. Licensed users will be switched to the selected plan - Replace all license assignments with the licenses from the selected plan. Licensed users will be switched to the selected plan.

NOTE:

OneDrive for Business that have not been licensed on the source tenant will retain the unlicensed status in the target tenant.
Selected licensing option is only applicable to OneDrive migration. It does not affect the licensing plans picked for Mail Migration.

Click Next.

Step 5: Filter Items
1. Set up filters as described below:
  - All items - select this option to ignore filters. This is the default option and all OneDrive Content for the selected account will be migrated.
  - All items that were added or modified since the last successful migration - select this option to migrate items that were added or modified in the source since the last successful migration. The migration service will check the Last Successful Run attribute and migrate every item added or modified in the source. If the OneDrive has not been successfully migrated before, all items will be migrated.
  - Items to exclude - select this filter option to exclude files and folders from the migration. Then specify the filter criteria. Items are excluded if any of the following criteria are fulfilled:
    - Exclude specific folders- provide a semicolon-separated list of relative paths to folders that you want to skip. You can use slash or backslash. If it is convenient for you, use spaces after semicolons, e.g., filteredfolder; somefolder/subfolder
    - Exclude specific file types - provide a semicolon-separated list of file extensions. The values are not case sensitive. You can use spaces and dots, e.g., .exe; dll; bat; doc; pdf
    - Exclude files created
      - select Before from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files created before this date will not be migrated.
      - select After from the dropdown and then click in the date field that appears to open the date picker and select a date. Files created after this date will not be migrated.
    - Exclude files modified
      - select Before from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files modified before this date will not be migrated.
      - select After from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files modified after this date will not be migrated.
    - Exclude files bigger than (MB) - enter a numeric value. The maximum value is 1000 MB. Only integer values are supported.
  - Items to include - select this filter option to include files and folders from the migration. Then specify at least one filter criteria. Items are included if any of the following criteria are fulfilled:
    - Include specific folders- provide a semicolon-separated list of relative paths to folders that you want to include. You can use slash or backslash. If it is convenient for you, use spaces after semicolons, e.g., filteredfolder; somefolder/subfolder
    - Include specific file types - provide a semicolon-separated list of file extensions. The values are not case sensitive. You can use spaces and dots, e.g., .exe; dll; BAT
    - Include files created
      - select Before from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files created before this date will be migrated.
      - select After from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files created after this date will be migrated.
    - Include files modified
      - select Before from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files modified before this date will be migrated.
      - select After from the dropdown. Then click in the date field that appears to open the date picker and select a date. Files modified after this date will be migrated.
    - Include files bigger than (MB) - enter a numeric value. The maximum value is 1000 MB. Only integer values are supported.
2. Click Next.
Step 6: Notification
1. Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
  - Only in a case of failure - Select this option to send the email if the discovery task fails to complete successfully.
2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
3. Click Next.
Step 7: Schedule
1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
  - Run now - task runs immediately.
  - Run later - task must be started manually.
  - Schedule - task will be started at a future date and time entered in the corresponding calendar field.
  - Priority - select a priority from the dropdown for the objects scheduled for migration with this task . Values are: Highest, High, Medium, Low and Lowest. The default priority is Medium. If the system is busy, the objects are queued (Migration state = Queued). When the system accepts new migration work, objects are taken from the queue based on the assigned priority and age in the queue.
2. Click Next.
Step 8: Auto rerun
1. Auto re-run task if target user(s) are missing any files or folders - Select this option to rerun the migration task for files or folders that failed to migrate on the first run. The migration task will auto rerun once only. Failure of the files to migrate the first time could be because of intermittent network issues or throttling. We recommend that this setting remains selected.
  This setting is enabled but read-only if the Migrate permissions in the Auto rerun task option is selected in Step 2: Attribute Options. Auto re-run is not available if an alternate migration location has been specified in Step 1 or item filters have been configured in Step 5.
  
  The migration service will issue an event warning for all files that fail to migrate. You can also check the batches for how many files failed to migrate.
2. Click Next.
Step 9: Reporting

Select the check box Generate detailed report of migration errors to generate a migration error report when you run the OneDrive Migration Task.

You can download the report from the Reports tab of the Accounts and User Data migration workspace by clicking the Download link in the Error Log column. If there are no migration errors, a download link is not available. Error reports are retained for 30 days. After 30 days the download link is replaced with the label Expired and you can no longer download the report. For more information about error reports, see Reports.
Step 10: Summary
1. Verify the task specifications as described below:
  - Name - name of the task. You can specify a custom name. The default name is OneDrive Migration Task.
  - Source tenant - name of the tenant where the statistics will be collected.
  - Target tenant - name of the target tenant in this project.
  - Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
  - Priority - the priority of this task.
  - File migration - migration action when a file is migrated.
  - Versions to migrate - options to migrate the version history.
  - Account to display - account name that will be displayed in the Created by and Modified by properties of migrated content:
  - Alternative migration location - default is the root folder or an alternate target migration folder
  - Sharing permissions - how sharing permissions will be transferred to the target users.
  - Auto-rerun - option to rerun the migration task for files or folders that failed to migrate on the first run.
  - Reporting - option to collect and retain data for report generation.
2. Click Back to change configurations if necessary or click Finish to save and start the task as scheduled.

Tracking the progress of the migration task

While the OneDrive Migration Task is running, click Assessment to track the progress of the migration task.

The following summary reports are available and described below.

OneDrive Users
Migration Progress is updated in real time.
Migration Statistics

OneDrive Users

The Users figure at the top of the OneDrive users pane reports on the total number of OneDrive users to migrate.

Account migration and matching reports on the number of OneDrive users matched and not matched.

OneDrive provision in target reports on the number of provisioned users.

Migration Progress

The migration progress pane reports on the status of the migration of OneDrive users. It is updated in real time.

Statistic	Description
Last Run Status	This data relates to the Last Run Status column on the List View tab. Show data from the last run status: new, in progress, completed, failed, stopped.
Progress of Started Users	Started Users = The users listed on the List View tab with Migration Progress % greater than zero. The bar chart shows the Migration Progress % for users. It shows how many users have Migration Progress % at fewer than 50%, 50% to 95%, 95% to 99%, and 100%. For example, if the diagram shows 63 users at 100% then 63 users have Migration Progress % value of 100%. How is Migration Progress % calculated? It is calculated as a ratio of the number of target items to the number of source items. If 10 items have migrated to the target and there are 100 items to be migrated on the source then the ratio for that user Migration Progress % is 10%.
Average % for started users	This is the average Migration Progress % value for users on the List View.

Statistic

Description

Last Run Status

This data relates to the Last Run Status column on the List View tab. Show data from the last run status: new, in progress, completed, failed, stopped.

Progress of Started Users

Started Users = The users listed on the List View tab with Migration Progress % greater than zero.

The bar chart shows the Migration Progress % for users. It shows how many users have Migration Progress % at fewer than 50%, 50% to 95%, 95% to 99%, and 100%. For example, if the diagram shows 63 users at 100% then 63 users have Migration Progress % value of 100%.

How is Migration Progress % calculated? It is calculated as a ratio of the number of target items to the number of source items. If 10 items have migrated to the target and there are 100 items to be migrated on the source then the ratio for that user Migration Progress % is 10%.

Average % for started users

This is the average Migration Progress % value for users on the List View.

Migration Statistics

The migration statistics pane reports on statistics recorded for the last 14 days.

Total migration file size for entire project (last 14 days)
Total migration file count for entire project (last 14 days)

Dependent on the scope of the file migration the content of OneDrive storage is transferred in batches that can be submitted for processing to OneDrive at the same time to be processed concurrently, it can take a while for OneDrive to complete processing of submitted batches. Refer also to the Events tab while the migration task is running.

Viewing the report

Open the Tasks tab.
Select the OneDrive Reporting Task (or your custom name) that you want to review.
In the task details pane that opens click Events (number).
Select the event with the description: Link to download the report is in the Details pane. Report link is active for 1 hour.
Click the report link in the details pane.
You can rerun the OneDrive Reporting Task after 1 hour to generate another report, and follow the same steps described here to view the report.

#	Step
1	Create a migration project (created automatically with New Migration UI)
2	Grant necessary permissions in case these permissions are not already granted (Prerequisites) IMPORTANT: It is not recommended to use existing user accounts as source and target temporary Migration Manager accounts, because it is recommended to remove them for safety reasons after the migration will be completed. These accounts can be removed from teams as described in Finalizing the Migration.
3	Discover teams/groups on the source tenant On this step you can see names, suggested for target teams. In case you need some changes use manual mapping as described below. There are no provision on the target on this step. TIP: Organize teams in collections to streamline the provision and migration process
4	Export teams mapping to CSV file
5	Map teams manually using exported CSV file You can use manual mapping to migrate source team to the target team with another name. If the channel do not exist, it will be provisioned. Also you can use manual mapping to merge several source teams to one target team.
6	Create Microsoft 365 Groups and Provision teams on the target tenant. Target teams will be owned by the target temporary Migration Manager account that is used to perform the provisioning. The temporary Migration Manager account in the source tenant will be added to all source teams as a member, and source private channels as an owner. The temporary Migration Manager account in the target tenant will be added to all target teams and Microsoft 365 Groups as a member and an owner, and target private channels as an owner These accounts can be removed from teams as described in Finalizing the Migration.
7	Migrate teams Migrate / merge all conversations (including inline content) from the source to target channels. Target temporary Migration Manager account will own all private channels migrated to the target.
8	remigrate teams to incorporate supported changes made after the migration task (step 7) was started.
9	Monitor the progress and track issues