Chat now with support
Chat with Support

Welcome, erwin customers to Quest Support Portal click here for for frequently asked questions regarding servicing your supported assets.

Metalogix Essentials for Office 365 2.4 - User Guide

Metalogix Essentials for Office 365 User Guide
Administrator Architect Backup
Interface Overview Common Functions
Connecting to SharePoint and OneDrive for Business Connecting to Cloud Storage Global and SharePoint Administrators Hyper Backup Creating a Full Backup Creating an Update Backup Creating an Exchange Online Mailbox Backup Creating an Office 365 Group Backup Creating a OneDrive for Business Backup Backup Resume Backup Search Restore from Backup Scheduling Backup Jobs Retention Policies Import/Export Backup Archives Moving the Backup Location Backup Project Conversion
Drives
Interface Overview Common Functions
Connecting to Drives Copy Google Drive Copy File Share Copy My Sites to OneDrive for Business Copy Tenant Copy Box Copy Dropbox OneDrive Management Progress Tab Hyper Migration Path Length Overflow
File Manager Informant Migrator
Interface Common Functions
Connect to SharePoint and OneDrive for Business Global and SharePoint Administrators Copy Sites Live Compare Copy Lists and Libraries Copy, Move, and Tag SharePoint Content Copy Alerts Pre-Migration Report Azure Turbo Mode In-Place Tagging of SharePoint Items Incremental Copy Nintex Workflow Migration Orphaned Users Copy Preserving Content Authorship and Approve/Reject Statuses Save Site to XML Using Scripts and Integration With Windows Task Scheduler
Profile and Global Variables Public Folders for SharePoint Reporting and Re-Mapping Users and Templates Security Manager Term Store Manager Scripts Wizards Appendix

Copy OneDrive to OneDrive

A simple Administrator driven wizard is provided to bulk migrate the Documents library content from the OneDrive for Business sites in one Office 365 tenant into the appropriate OneDrive for Business Documents library in another Office 365 tenant.  In order to successfully configure and run this operation, you will need to be able to authenticate against both SharePoint Admin Center portals in Office 365 using a Global Administrator login.  A mapping file may also be needed in order to resolve the user accounts between the source and destination tenants.

This operation has the following requirements for use:

·The account used to perform the migration needs to be a Global Administrator in the source Office 365 tenant.

·The account used to perform the migration needs to be a Global Administrator in the target Office 365 tenant.

·The person performing the migration will need to know the relationship (mapping) between the user accounts in the source and target Office 365 tenants.

·Each user account must have either a SharePoint or OneDrive license assigned to it in Office 365.
 

Once the requirements above are satisfied, you can proceed with utilizing the bulk upload functionality.

1.Switch to the Drives tab in the Essentials console and click the button "Copy Tenant" located in the ribbon, and select Copy OneDrive to OneDrive.
copy onedrive to onedrive1

2.When the wizard appears, select a Profile and give your project a name.
copy one drive to one drive

3.Enter a SharePoint Admin  Center URL for the source Office 365. Once the URL is entered, click the Connect button, enter a valid Global Admin account and click Connect.

info

NOTE: that the Claims option is not supported for this operation.  

onedrive to onedrive hyper migration 3
When you receive a successful connection message proceed to the next parameter. You may also choose to add additional Admin account by selecting the "+Admin" button.

4.Enter a SharePoint Admin Center URL for the target Office 365.  Once the URL is entered, click the Connect button, enter a valid Global Admin account and click Connect.

info

NOTE: that the Claims option is not supported for this operation.

 
onedrive to onedrive hyper migration 2
When you receive a successful connection message proceed to the next step. You may also choose to add additional Admin account by selecting the "+Admin" button.

5.Click the Load OneDrives from source button. In the table, a list of currently provisioned OneDrive for Business sites will be loaded.
copy onedrive to onedrive4

6.You can also choose to Load and Apply report option, which allows you to load and apply an Analyze OneDrive report, which then sets the Migration Priority for each user mentioned in the report. Click Next to continue.

info

NOTE: Each Migration Priority value can be changed if you click on the value in the Migration Priority columns (without user selection). It changes the migration queue but does not change the original report file. Priority in the wizard is not saved after the wizard has been closed.

Analyze OneDrive 4

7.On the second page of the wizard, if a user mapping file is required, check the box next to Re-Map Users and then load the mapping file (For an overview on how to create a CSV mapping file for your users, please see the User Mapping section).
copy onedrive to onedrive6

8.Click the Check for users personal sites button.  This operation will verify that the user account listed in the mapping file was found in the target Office 365 and it will also determine if the user's OneDrive for Business site is currently provisioned.
copy onedrive to onedrive7
If the user is valid in Office 365 but does not currently have a OneDrive for Business site, please check the option labeled "Create personal sites for the selected users" which will instruct the software to provision the necessary sites.

9.Click Next to continue.

10.The final page provides a few options to configure how the content portion of the operation should be configured.

Content Options
copy onedrive to onedrive8

Copy Sub-Sites - Enable this option to include all sub-sites of the current site in this operation.

Copy Permissions - This option will enable the transfer of internally shared permissions from the source to OneDrive for Business. For source Google Drive migrations, this will include internally shared folder and item-level permissions. For source SharePoint My Site migrations, this will include internally shared site, list and item level permissions. For source Box migratons, this will include internally shared folder collaborators. For source Dropbox migrations, this will include internally shared folder permissions.

Copy Content - Enabling this option will copy all of the content from your Source to your Target. You can further specify if you would like to include all versions of the content from your source, or only the specified most recent versions.

 
Overwrite if file exists - In a version library, selecting the "Overwrite if File Exists" option does not overwrite the files already in SharePoint. SharePoint will append these to the list as new versions.
 
Incremental Copy - Incremental or delta migrations are an important and powerful option for large or ongoing projects and migration validation. Once enabled this option will migrate new, modified or versioned content from the source to the destination, capturing changes made by users during the previous migration. The value entered into the "Last" field will limit the amount of content examined to the time period specified, starting at present time. To perform an incremental migration, enter the amount of time to include and select the appropriate time period in days, weeks or months. Incremental migration is designed to be used in scenarios where the destination is not being modifed. To perform a delta migration, enter zero in the field and select days as the time period. Delta migration is designed to be used in scenarios where both the source and destination may be modified during the course of the migration. Please note that a delta migration compares dates between source and destination to determine which content to include, so it will take more time to process than an incremental migration.

info

NOTE: The Overwrite if File Exists parameter will be disabled if this option is selected.


Skip files greater than - When enabled, this option will skip any source files that are greater than the value specified (in MB or GB). An entry will be added to the post-migration log indicating which file(s) were skipped due to this configuration.
 
Re-Map Site and List Templates - This feature allows for the re-mapping of list or site templates. Download the Site and List Template Report. To do this:

1.Right click on a site in the Navigation View and go to Reports > SharePoint Site and Templates(csv). Alternatively choose the Reports Menu and then choose the Site and List Templates button on the ribbon. Enter a file name and select a location to download the CSV report, then select "Save".

2.Open and review the template report. Choose the Source Template ID and the Target Template ID you would like to Re-Map.

3.Create a new CSV file and insert the Source template ID into column A, and the Target template ID into Column B. Save the new CSV file.

4.During a copy operation, select Re-Map Site and List Templates, and then choose "Load". Select the new CSV file containing Source Template ID and Target Template ID. Once you are satisfied with your settings, press the "Next" button located at the bottom of the window to continue to the Summary window. Review your migration settings one more time and press the "Finish" button to initiate the operation.

Advanced Options
advanced options in Drives wizard alt 2

Enable Azure Turbo Mode: When enabled, this option utilizes Microsoft's SharePoint Online Migration API to increase the migration performance and throughput. A recommendation for optimal use of this API is larger sets of data; the more content, the better the throughput. Please review the User Manual for additional information as well as recommended configuration as this process is a resource intensive operation.

Because this API uses Azure storage as a staging area for the migration, it requires that you provide an Azure storage location. The options are to either utilize Microsoft supplied storage or to provide your own Azure storage location. If you wish to use your own Azure account, you must provide both the Azure Account Name as well as the corresponding Acces Key. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding or consider using the Microsoft Supplied Storage option. For more information please see the Azure Turbo Mode section.

info

NOTE: this function is optional and is only used to increase the migration performance to SharePoint Online or OneDrive for Business in Office 365. It does not provide any additional functionality that is not available when this option is disabled.

·Microsoft Provided Storage: This option allows you to use Microsoft provided Azure storage instead of providing your own for the purpose of utilizing Azure Turbo Mode.

info

NOTE: the migration end result will not differ regardless of your selection between Microsoft or User provided storage.

·User Provided Storage: This option allows you to provide your own Azure Storage instead of using one provided by Microsoft for the purpose of utilizing Azure Turbo Mode. It requires that you provide both your Azure Blob Storage Account Name as well as its corresponding Access Key by clicking the "Select" button to the right. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding.

info

NOTE: that the migration end result will not differ regardless of your selection between Microsoft or User provided storage.

oDefer Upload to Azure: When enabled, this option does not upload and immediately queue the import process from Azure storage, but rather saves the packages to a file location to then be uploaded and imported at a later time. This will allow you to use another application (at any time) to upload the content to Azure.

§To make use of the Deferred Upload option, the following process takes place:

1.First, you should setup the operation as usual using the Azure Turbo option.

2.Then, check the Defer Upload to Azure option and then Select the location where you wish to store the packages. Please be sure that there is enough disk space to accommodate all the packages that will be created.

3.During this process, the packages will be created, saved to this location and empty containers will also be created in your Azure storage.

4.After the operation completes, you will need to upload (using whichever upload utility you choose) the contents of each local folder into the appropriate Azure container. The folder names created in your local file location will be named exactly the same as the containers in Azure.

5.Once all the content from each folder is uploaded to the appropriate container in Azure storage, open the Azure Turbo Queue and choose the Refresh option.

6.Select one or more of the "Pending" jobs, right click and choose Process. The Import process has now begun and the jobs should soon switch to the status Queued.

oSend Notification: When selected, this feature will send emails to the listed recipients once Migrations are completed.

11. Click Finish to begin the migration.

Copy Office 365 Groups to Office 365 Groups

A simple Administrator driven wizard is provided to bulk migrate the Office 365 Group sites from one Office 365 tenant to another Office 365 tenant.  In order to successfully configure and run this operation, you will need to be able to authenticate against both SharePoint Admin Center portals in Office 365 using a Global Administrator login.  A mapping file may also be needed in order to resolve the user accounts between the source and destination tenants.

This operation has the following requirements for use:

·The account used to perform the migration needs to be a Global Administrator in the source Office 365 tenant.

·The account used to perform the migration needs to be a Global Administrator in the target Office 365 tenant.

·The person performing the migration will need to know the relationship (mapping) between the user accounts in the source and target Office 365 tenants.

·Each user account must have either a SharePoint or OneDrive license assigned to it in Office 365.

 

Once the requirements above are satisfied, you can proceed with utilizing the bulk upload functionality.

1.Switch to the Drives tab in the Essentials console and click the button "Copy Tenant" located in the ribbon, and select Copy OneDrive to OneDrive.
copy office365 group to office265 group1

2.Select a Profile and give your project a name.
copy office365 group to office265 group001

3.Enter a SharePoint Admin Center URL for the source Office 365. Once the URL is entered, click the Connect button, enter a valid Global Admin account and click Connect.

info

NOTE: that the Claims option is not supported for this operation.  

copy office365 group to office265 group2
When you receive a successful connection message proceed to the next parameter. You may also choose to add additional Admin account by selecting the "+Admin" button.

4.Enter a SharePoint Admin Center URL for the target Office 365.  Once the URL is entered, click the Connect button, enter a valid Global Admin account and click Connect.

info

NOTE: that the Claims option is not supported for this operation.

 
copy office365 group to office265 group3
When you receive a successful connection message proceed to the next step. You may also choose to add additional Admin account by selecting the "+Admin" button.

5.Click the Load from Office 365 Group button.
copy onedrive to onedrive4

6.In the table, a list of currently provisioned domain users will be loaded.  Check the box next to each user that will be included with this operation. Click Next to continue.
copy office365 group to office265 group4

7.On the second page of the wizard, if a user mapping file is required, check the box next to Re-Map Users and then load the mapping file (For an overview on how to create a CSV mapping file for your users, please see the User Mapping section).

info

NOTE: If OAuth authentication is being used for this migration, owners and members will be copied by default, please note that in order for these users to be migrated, you must have them mapped in the same CSV mapping file with the groups mapping. See the OAuth section for more information on how to set up OAuth Authentication.

copy office365 group to office265 group5

8.Click the Check Office 365 Group button.  This operation will verify that the user accounts listed in the mapping file were found in the target Office 365.
copy office365 group to office265 group6

9.Click Next to continue.

10.The final page provides a few options to configure how the content portion of the operation should be configured.

Content Options
copy onedrive to onedrive8


Copy Content - Enabling this option will copy all of the content from your Source to your Target. You can further specify if you would like to include all versions of the content from your source, or only the specified most recent versions.

 
Incremental Copy - Incremental or delta migrations are an important and powerful option for large or ongoing projects and migration validation. Once enabled this option will migrate new, modified or versioned content from the source to the destination, capturing changes made by users during the previous migration. The value entered into the "Last" field will limit the amount of content examined to the time period specified, starting at present time. To perform an incremental migration, enter the amount of time to include and select the appropriate time period in days, weeks or months. Incremental migration is designed to be used in scenarios where the destination is not being modifed. To perform a delta migration, enter zero in the field and select days as the time period. Delta migration is designed to be used in scenarios where both the source and destination may be modified during the course of the migration. Please note that a delta migration compares dates between source and destination to determine which content to include, so it will take more time to process than an incremental migration.

info

NOTE: The Overwrite if File Exists parameter will be disabled if this option is selected.


Skip Non-Owned Folders - This option addresses the scenario where folders appear in a user's Box account which are not owned by this user; the user is a folder collaborator and not the folder "Owner". Skipping these folders will prevent duplicates from being migrated into Office 365 Groups because the folder will be migrated only once when the folder "Owner" is migrated.
 
Skip files greater than - When enabled, this option will skip any source files that are greater than the value specified (in MB or GB). An entry will be added to the post-migration log indicating which file(s) were skipped due to this configuration.
 
Migrate to Folder - When this option is enabled, you can create a (or use an existing) root folder structure in the destination library where your source content will be migrated. You will need to define the path
 
Apply Filter - This feature allows the inclusion or exclusion of items by user defined criteria, such as date, size, file extension, file name, or file owner.

 

Advanced Options
advanced options in Drives wizard alt 2

Enable Azure Turbo Mode: When enabled, this option utilizes Microsoft's SharePoint Online Migration API to increase the migration performance and throughput. A recommendation for optimal use of this API is larger sets of data; the more content, the better the throughput. Please review the User Manual for additional information as well as recommended configuration as this process is a resource intensive operation.

Because this API uses Azure storage as a staging area for the migration, it requires that you provide an Azure storage location. The options are to either utilize Microsoft supplied storage or to provide your own Azure storage location. If you wish to use your own Azure account, you must provide both the Azure Account Name as well as the corresponding Acces Key. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding or consider using the Microsoft Supplied Storage option. For more information please see the Azure Turbo Mode section.

info

NOTE: this function is optional and is only used to increase the migration performance to SharePoint Online or OneDrive for Business in Office 365. It does not provide any additional functionality that is not available when this option is disabled.

·Microsoft Provided Storage: This option allows you to use Microsoft provided Azure storage instead of providing your own for the purpose of utilizing Azure Turbo Mode.

info

NOTE: the migration end result will not differ regardless of your selection between Microsoft or User provided storage.

·User Provided Storage: This option allows you to provide your own Azure Storage instead of using one provided by Microsoft for the purpose of utilizing Azure Turbo Mode. It requires that you provide both your Azure Blob Storage Account Name as well as its corresponding Access Key by clicking the "Select" button to the right. If you cannot supply this information, please search our online Knowledge Base, User Manual or contact Support for additional information before proceeding.

info

NOTE: that the migration end result will not differ regardless of your selection between Microsoft or User provided storage.

·Defer Upload to Azure: When enabled, this option does not upload and immediately queue the import process from Azure storage, but rather saves the packages to a file location to then be uploaded and imported at a later time. This will allow you to use another application (at any time) to upload the content to Azure.

§To make use of the Deferred Upload option, the following process takes place:

oFirst, you should setup the operation as usual using the Azure Turbo option.

oThen, check the Defer Upload to Azure option and then Select the location where you wish to store the packages. Please be sure that there is enough disk space to accommodate all the packages that will be created.

oDuring this process, the packages will be created, saved to this location and empty containers will also be created in your Azure storage.

oAfter the operation completes, you will need to upload (using whichever upload utility you choose) the contents of each local folder into the appropriate Azure container. The folder names created in your local file location will be named exactly the same as the containers in Azure.

oOnce all the content from each folder is uploaded to the appropriate container in Azure storage, open the Azure Turbo Queue and choose the Refresh option.

oSelect one or more of the "Pending" jobs, right click and choose Process. The Import process has now begun and the jobs should soon switch to the status Queued.

·Send Notification - enter specific user email addresses to denote who will receive notifications.

11.Click Finish to begin the migration.

Modern Pages Migration

The following are supported features and requirements for the migration of Modern Pages when doing an Office 365 Group to Office 365 Group Migration:

 

·Functionality works only for modern pages (Inherits="Microsoft.SharePoint.WebControls.ClientSidePage" )

·Pages should be published on source.

·Works only through CSOM. If migration was started with azure -pages migration would go in to CSOM and can be done only in sync mode.

·Functionality works only for out-of-box Pages, library automatically created when group site is created or team site is created.

·Overwrite of pages is not supported. Overwrite and Incremental/Delta works the same - Target pages would be deleted and new pages with web-parts would be created.

·Pages history for modern pages is not supported and will not be preserved.

·Core properties for modern pages should be preserved for last page version.

·Web part ID should be updated after it was created on the target page.

·Link inside web part referencing on lists should be updated after it was created on the target page.

·If reference object is missing on target (was not copied because of errors, was excluded from migration, deleted from target before migration) the web part is copied as close as it can be. There will be no errors logged for the web part or for the page migration in post migration log.

·app.log in job log must have the line :
"Create modern page :: ::  page name.aspx has web parts:  updated:  list- webpart id , list - webpart id, image - id and not updated: map id".  For example  : Create modern page :: :: page Home.aspx has web parts:  updated:  Image-edbf790c-7047-4f81-9893-c90e35eaf3db List-9d86e730-a1ff-4631-aeb2-6f52a097e339 List-e6158eca-b230-42d3-a5a8-7ca7840e44c3 DocumentEmbed-459d5426-ed40-4031-accb-d33f59006f98 and not updated:  ContentRollup-66046009-2f07-40e0-b3da-28d4196f956b LinkPreview-e6195746-3090-46c2-8c94-ff31fc009d9f.  
This info will give an explanation about supported web parts and not supported web parts. Web parts next to not updated were not modified by the tool and will not work on the page. 

·Section layout should be the same as on the source. List of supported layouts: one column, two column,  thee columns, one-third left column, one-third right column. Section background is not supported

·Web part should be placed on the same section and same zone as on the source page.

·Tool will create a .txt file with original page history just to save this information somewhere and share it with end-users.

 

List  of supported Web Parts

·Text (Supported properties: simple text without formatting)

·Image (Supported properties: link to image; only for current site - sub sites and other site are not supported)

·Highlighted content (Supported properties: Source - this site , Type - documents , Document Type - any)

·Document Library (Supported properties: Document lib link reference)

·List (Supported properties: List link reference)

·File Viewer (Supported properties: File link reference)

·Link (link reference)

Analyze OneDrive

This option allows administrators to analyze content from OneDrive. This includes the number of folders, sub folders, and files for each user selected to be analyzed in the report. The report will also categorize the user's priority by their account size.

This operation has the following requirements for use:

·The account used to perform the analysis needs to be a Global Administrator in this Office 365 tenant.

To analyze the content of your OneDrive, perform the following:

1.On the Drives tab click Copy Tenant and select "Analyze OneDrive ".
Analyze OneDrive 1
The Analyze Google wizard opens.

2.Provide your SharePoint Admin URL, click Connect.  On the Connect to SharePoint popup, enter your SharePoint credentials and click Connect. If you receive any message other than "Successfully connected to SharePoint Admin URL", please double check your credentials or contact support.
Analyze OneDrive 2

3.Click Load from Tenant to load a list of available OneDrive user accounts from your environment.

Analyze OneDrive 3

4. Click the Select button to specify a location and a name for this report.
analyze dropbox4

5.Click Finish to begin the analysis.

Please visit the following link for an overview on how to script and schedule jobs such as Analyzing OneDrive.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating