Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - SharePoint Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint Migrating to O365 Using the Azure Pipeline/SPO Containers Preparing for a Migration How Content Matrix Handles Various SharePoint Components Initiating a Migration Configuring Copying Options Saving or Running a Migration Action Copying SharePoint Objects as a Separate Action Self-Service Migration Incremental Migration Log Files Using PowerShell with Content Matrix
Configuring PowerShell for Use with Content Matrix
Registering Metalogix Command DLL Files Adding PowerShell Snap-Ins for the Application Framework Content Matrix PowerShell Commandlet List
Metalogix.System.Commands Metalogix.SharePoint.Commands Metalogix.Jobs.Reporting.Commands Metalogix.SharePoint.Migration.Commands
Modifying Content Matrix Configuration and Settings Configuring Content Matrix for Distributed and Self-Service Migration Frequently Asked Questions
DB_Owner Permission Migrating with the Fabulous 40 Templates Item Count Discrepancies Keyboard Shortcuts License Key Troubleshooting Determining the Status of a Migration Running in the Background MySite and User Profile Migration Issues Optimal Setup for Best Performance Using Proxies, Load Balancing or Alternate Access Mappings Troubleshooting the Extensions Web Service Installing the Extensions Web Service on Specific Systems Extensions Web Service Installation Files Using Older Versions of the Extensions Web Service Preserving IDs when Migrating a Custom List as a Folder Migrating JavaScript Migrating Site Variations Migrating with SharePoint Document IDs Changing a Job Configuration for Multiple Files SharePoint 2003 Version Migration Limitations SharePoint 2013 and Later Site Collection Creation Issue Job List Database fails to Load After Upgrade Customized Wiki Page Web Part Zones Not Being Migrated Preserving SharePoint List Item IDs with a CSOM Connection Type Retrying Failed Document Copies to O365 CSOM Connections Migrating Content When the Source Custom List Template is Missing Are SharePoint Online Migrations Throttled? What to Expect when Migrating with StoragePoint on the Target Migration Error Message 'There was an Error Reading from the Pipe: The Pipe has been Ended (109, 0xd6)' How do I Remove Items from My Azure Blob Storage Account? Azure Batches Getting Stuck "Error, the batch will be resubmitted" Message Displays When Using Azure Item Count at Target is Increased When Migrating Using the Azure Pipeline Custom Lists with Versioning Enabled Not Being Migrated When Using the Azure Pipeline Supported Nintex Actions for SPO Migration "Insufficient Credentials" Message Connecting to Modern Team Site Using Web Browser Authentication Error Making a Browser-Based Connection with PowerShell Console Open
About Us

Migrating as an SPO Modern Team Site

Modern team sites in SharePoint Online are team sites integrated with Office 365 groups  for improved collaboration. When a modern team site is created, SharePoint Online automatically creates the O365 group and group email address.  Because of the differences between modern team sites and "old-style" team sites, special considerations apply.

In addition to migration considerations, there are also factors to consider when Connecting to SPO Modern Team Sites.

Modern Team Site Migration Limitations

You can use Content Matrix to migrate old-style team sites to modern team sites, as well as from one modern team site to another.  However, the following limitations apply:

·The migration of modern team site Owners and Members:

§is only supported by the Paste as Modern Team Site action


§is not supported for the Web Browser Authentication type.

·Currently, Content Matrix does not support modern pages and web parts.  Instead, "old style" pages and web parts will be used on the target.

To initiate a Modern Team Site Migration:

1.In Explorer View, select the site you want to copy.

2.Right-click and choose Copy Site.

3.Select the target Office 365 Tenant Modern Team Sites node.

4.Right-click and choose Paste as Modern Team Site > Admin Mode.

Modern Team Site Paste Menu

Once the mode is selected, the Configure Modern Team Site Copying Options dialog displays.

Continue with Configuring Copying Options.

Migrating MySites

The following are the supported source/target combinations for migrating MySites:

·Any source server with SharePoint 2007 or later (using the Web App or Farm connection types) to any target server with SharePoint 2007 or later (using the Web App or Farm connection types).

·Any source server with SharePoint 2007 or later (using the Web App or Farm connection types) to an Office 365 Tenant environment.

·A source Office 365 Tenant environment to a target Office 365 Tenant environment.

Advanced Mode Icon  This option is only available when Advanced Mode is enabled.


Connection icon

When migrating MySites, the target side connection must be a Web App or Farm connection type, using the Local or Extensions Web Service connections for on premise installations of SharePoint. For Office 365 target environments, the Office 365 Tenant connection type must be used.  This allows users to connect at a Site Collection level to the Office 365 environment so they can run Site Collection migrations.

It is recommended that the Web App" or Farm connection types be used on the source side as well. Other connection types can be used on the source, such as the Database connection. However, this will have some limitations. If these other connection types are used on the source, MySites can still be migrated to the target, but they will be migrated as Site Collections (not using the MySite template), and as a result, will not include some of the User Profile data and other data that the normal MySite migration will preserve.

When migrating SharePoint MySites to a SharePoint 2013 or later target, a Local OM or a Remote OM connection can be used. However, due to some User authentication changes that have been made beginning in SharePoint 2013 that inadvertently restrict the creation of Site Collections (MySites are a type of Site Collection), using the SharePoint OM remotely, Metalogix Content Matrix needs to use a set of elevated permissions to create Site Collections. In order for these elevated permissions to be used, the migrating user account must explicitly (by name) have "Full Control" permissions on the Web Application that the Site Collection is being created on. A preliminary check will be made before elevation occurs to ensure the migrating user has enough permissions initially to be able to use the elevated Site Collection creation. Creating Site Collections for a SharePoint 2013 or later target with the Local OM connection type does not have this same restriction, but the same permissions are recommended in case elevated permissions are needed. Please see Connecting to SharePoint for more details on this connection types. For more information on this specific issue, please see SharePoint Site Collection Creation Issue.

The same issue, for requiring elevated permissions, can be encountered in SharePoint 2010 environments using Claims authentication.

Note that in order to view MySites when migrating to an Office 365 Tenant environment, the Include Office 365 tenant my site host connection check box must be enabled when the connection is created. The MySites are then displayed under their own top-level root node. For more information, please see Connecting to SharePoint O365 Tenant.

Migrating MySites into a Target that Uses OneDrive

When migrating MySites into a target SharePoint environment that uses OneDrive, Metalogix Content Matrix will use a slightly different method to migrate some of the content. Any documents on the source that are in the MySite Shared Documents or Personal Documents library will be migrated into a Shared with Everyone folder in OneDrive. This is done instead of migrating the documents into Document Libraries of the same name. As a result, this can cause some navigation copy issues because the Shared and Personal document libraries will not exist on the target, and because they do not exist, they cannot be added to the navigation.

Additionally, web parts that exist on landing pages in SharePoint 2007/2010 will not be migrated to SharePoint 2013 or later.

Required Permissions for Migrating MySites

Migrating MySites requires slightly higher permissions than other copy actions. The basic permissions needed to migrate MySites are as follows:

·Full Control permissions are required on the target Web Application. This is because when migrating MySites, the migrating user will not necessarily have access to the newly created MySite, and without access to the new MySite, you would be unable to migrate any other general content into it without getting permission errors. If this account has Full Control on the web application that the MySite is being created on, then it would still be able to migrate content into the new MySite because it will still have access (without making the migrating account a Site Collection Administrator on the MySite).

·Farm Administrator permissions are required on the target SharePoint server to which the MySites will be migrated when migrating to a target that is using the Local Object Model (OM) connection.

EXCEPTION:  If the target connection is using the Remote OM connection through the use of the Extensions Web Service, then the Farm Administrator permission is not needed.

·Manage Profile permissions are required on the User Profile application (in Share Services). This option is mainly required when migrating User Profiles, and to help create and manage Managed Metadata for the user profiles.

These basic permissions allow for the creation and migration of MySites (personal sites) on the target, use of personal features, management of user profiles, and management of permissions (these can all be accessed through the Shared Service Applications in Central Administration).

Related Documents