Chat now with support
Chat with Support

Content Matrix 9.8 - SharePoint Edition User Guide

Introduction Activating the License Key Selecting the SQL Database You Want to Connect to Content Matrix Console End User Interface Enabling Advanced Mode Multilingual Support Connecting to SharePoint Preparing for a Migration How Content Matrix Handles Various SharePoint Components
Team Site to Modern Team Site Migration SharePoint Sites to Modern Communication Site Migration Promotion of First Level Subsites to Site Collections MySite Migration "Share With" Metadata and "Sharing Links" Access Permissions Migration Records Center to SharePoint Online Migration Using the Import Pipeline Master Page Migration List Template Gallery Migration Content Types Migration Document Version and Checked Out File Limitations Ghosted and Un-Ghosted Page Migration Document Set Migration Navigation Migration Classic Web Parts Migration Site Theme Preservation Site Feature Migration Managed Metadata Migration Users and Permissions Migration BCS/BDC Data Migration OneNote Notebooks Migration Customized Form Pages Migration InfoPath Forms Migration SharePoint Workflow Migration Nintex Workflows and Forms Migration Link Correction StoragePoint Content Migration
Initiating a Migration Configuring Copying Options Saving or Running a Migration Job Copying SharePoint Objects as a Separate Action Configuring Hub Sites Incremental Migration Using PowerShell with Content Matrix
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 Migration Frequently Asked Questions
DB_Owner Permission Keyboard Shortcuts Activating the License Key Silently License Key Troubleshooting Errors Connecting to SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-Enabled Environment Determining the Status of a Migration Running in the Background MySite and User Profile Migration Issues Optimal Setup for Best Performance Migrating SharePoint On Premises Using Proxies, Load Balancing or Alternate Access Mappings Extensions Web Service Installation Files Migrating JavaScript Migrating Site Variations Migrating with SharePoint Document IDs Changing a Job Configuration for Multiple Files SharePoint 2013 and Later Site Collection Creation Issue Customized Wiki Page Web Part Zones Not Being Migrated Preserving SharePoint List Item IDs When Migrating to SharePoint Online Retrying Failed Document Copies to SharePoint Online CSOM Connections Import Pipeline Batches Getting Stuck Migrating Content When the Source Custom List Template is Missing When Migrating to SharePoint Online HTTP Status Code 429 (“Too many requests”) or 503 (“Server Too Busy”) Message Returned How Do I Identify and Remove Containers and Queues from My Azure Private Storage Account? "Error, the batch will be resubmitted" Message Displays When Using the Import Pipeline Item Count at Target is Increased When Migrating Using the Import Pipeline Custom Lists with Versioning Enabled Not Being Migrated When Using the Import Pipeline Supported Nintex Actions for SPO Migration Support for GCC High Tenants
About Us

Multilingual Support

Navigation:  [No topics above this level]

Multilingual Support

Content Matrix supports migrations to SharePoint Online when the default language used on the source is different than the default language used on the target.

NOTE:  Multilingual migrations have been fully tested for a limited number of language combinations (including English, French, Spanish, Italian, and Arabic). However, you can perform migrations using other language combinations. If you encounter issues, contact Quest Support.

Prerequisites

·When making a connection to the target, the default language of the connecting account must use the same default language as the source.

EXAMPLE:  If you are migrating from English to Spanish, connect to the target with an account whose default language is English.

·The following keys in the ApplicationSettings.xml file must be set to True before performing a migration to a target with a different default language:

·IsMultiLingualMigration

·SkipExistingColumnsAndContentTypes

Supported Objects

The following objects are supported for cross-language migrations:

·Lists and Libraries

·Columns

·Content Types

·Workflows and Forms

·Users and Permission

·Site and List settings

·Web Parts

·Out of Box items and pages

·Views

NOTE:  Item-level (user-created) content is migrated in the source language.  This is a SharePoint limitation.

Connecting to SharePoint

Navigation:  [No topics above this level]

Connecting to SharePoint

The following basic connection adapters are supported for making connections to SharePoint from Metalogix Content Matrix Console:

·A local connection to a SharePoint site or server *

·A remote connection to a SharePoint site or server

· A client side object model (CSOM) connection for SharePoint Online at the site level

·An Office 365 Tenant connection (based on the CSOM connection type) `

·A read-only connection to a SharePoint Database (DB)

* As of version 9.3 the Metalogix Content Matrix Console client application requires Microsoft .NET Framework 4.7.2 to run. Since this .NET requirement applies to the machine on which Metalogix Content Matrix is installed, Metalogix Content Matrix cannot make a local Object Model (OM) connection on a SharePoint 2007 or 2010 environment, because SharePoint 2007 and 2010 require an earlier version of the .NET Framework (v.3.5), which prohibits Metalogix Content Matrix from completing the connection.  Because of this, any migration ‘jobs’ configured to connect to SharePoint 2007 and 2010 environments using a Local OM connection type will cease to work, and these jobs will need to be recreated for use over MEWS or DB.

The following table identifies the connection adapter types for each supported version of SharePoint:

SharePoint Server Type

Local Object Model (OM) Connection (Metalogix Content Matrix Console - installed on server)

Remote Object Model (OM) Connection (Metalogix Extensions Web Service installed on remote server)

SharePoint Client Side Object Model (CSOM) Connection

SharePoint Database (DB) Connection (Read Only)

SharePoint Office 365 Tenant Connection

Microsoft SharePoint 2007 (WSS and MOSS)

-

Green Checkmark

-

Green Checkmark

-

Microsoft SharePoint 2010 (Foundation and Server)

-

Green Checkmark

-

Green Checkmark

-

Microsoft SharePoint 2013 (Foundation and Server)

Green Checkmark

Green Checkmark

--

Green Checkmark

**

-

Microsoft SharePoint 2016

Green Checkmark

Green Checkmark

--

Green Checkmark

**

-

Microsoft SharePoint 2019

Green Checkmark

*

Green Checkmark

*

--

Green Checkmark

**

-

Microsoft SharePoint Server Subscription Edition

Green Checkmark

*

Green Checkmark

 

--

Green Checkmark

**

-

Microsoft Office 365

-

-

Green Checkmark

-

Green Checkmark

*  Currently, if Content Matrix is installed in a FIPS-enabled environment, you cannot connect to or migrate to/from SharePoint 2019 with a local or remote server connection. For SharePoint Server Subscription Edition in a FIPS-enabled environment, you can only connect using a remote object model connection.  See Errors Connecting to SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-Enabled Environment for more information.

**

·If Content Matrix Console is installed on a server where SharePoint is also installed, the appropriate version of the adapter will be configured automatically. If SharePoint is not installed on the same machine as the Content Matrix Console, the installer will prompt for the configuration of  a SharePoint 2013, SharePoint 2016, or SharePoint 2019/Subscription Edition database adapter, as more than one cannot exist on the same non-SharePoint machine at the same time. If you need to switch from one version of the database adapter to the other, you will need to first uninstall and then re-install the SharePoint edition using Modify operation.  If you are using Distributed Migration, you will also need to update the database adapter version on the agents

·You cannot connect to a SharePoint Server database from a machine that has SharePoint Server Subscription Edition installed, or to a SharePoint Server Subscription Edition database from a machine that has SharePoint Server installed.

For each of the direct connections to SharePoint (local OM, remote OM, CSOM, and Tenant) there is a full connection and a read-only connection (with the exception of DB connections, which are read-only by default). The Write and Read-Only connection states are available under the Add Connection menu, and are differentiated in the Explorer View tab by different icons (the read-only icon has a lock over the system connection).

Connection Type Functional Comparison

Connection Type Functional Comparison

Navigation:  Connecting to SharePoint >

Connection Type Functional Comparison

SharePoint Database Connection

The SharePoint Database connection is a read-only connection that accesses the  SharePoint data by reading the content databases directly from the SQL server used by an on premises SharePoint farm.

NOTE:  After connecting to a 2013 or later SharePoint database, you have the option of making an External Connection to a SharePoint server to allow large file migration.

Required Permissions

·For SharePoint 2013, 2016, 2019, and SharePoint Server Subscription Edition: The combination of Reader and Execute on the Content Database is the minimum set of required permissions, but the combination of db_dataReader and SPDataAccess can also be used.  

·For SharePoint 2007 and 2010:  Only Reader or DBReader on the Content Database is required.

Okta authenticaton support

N/A

When to Use

·When connecting to the source farm

·When there is a need to optimize migration performance

·When there is a requirement to use the Search function in SharePoint 2013

Optimal Use Cases

·Migrating SharePoint 2010 lists and libraries containing Managed Metadata using the Import Pipeline, provided all affected Metadata is migrated to the target and the source and target GUIDs of all affected Metadata is mapped

·Migrating workflows

·Migrating alerts to a SharePoint on premises target

·Connecting SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-enabled environment.

NOTE: You cannot connect to a SharePoint Server database from a machine that has SharePoint Server Subscription Edition installed, or to a SharePoint Server Subscription Edition database from a machine that has SharePoint Server installed

Unsupported Operations

·Creating and deleting SharePoint objects (because it is a read-only connection)

·Migrating Managed Metadada

·Migrating MySites (because they will be migrated as site collections and will not include some of the User Profile data)

·Migrating InfoPath forms

·Mapping site templates (because it can only detect site templates for any site that exists under the selected source node)

Local Object Model (OM) Connection

The local Object Model connection accesses the SharePoint on premises OM API locally on the machine, which allows it to preserve more existing metadata and grant deeper access for some Content Matrix features.

Required Permissions

Site collection and db_owner on SharePoint Admin, Config and content databases.

NOTE:  The connecting account must be the currently logged-in user.

Okta authenticaton support

N/A

When to Use

·When the Content Matrix Console is installed on a WFE server of an on premises SharePoint farm.

·On the target farm, to help with performance.

Optimal Use Cases

·Updating site collection settings

·Migrating web part connections

·Migrating Managed Metadata

·Migrating InfoPath forms

·Migrating List Template Gallery

·On the source farm:

§migrating alerts to SharePoint on premises

§migrating Audiences

§migrating Records Centers to SharePoint Online using the Import Pipeline

§preserving workflow associations

·On the target farm:

§migrating Site collections, including site collection administrators

§migrating MySites

§migrating Master Page Gallery

§preserving Site themes

§preserving SharePoint List and List Item IDs

§preserving Authorship metadata

§setting site quotas

§transforming list and site columns into a Managed Metadata column

Unsupported Operations

·Connecting to SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-enabled environment

Remote Object Model Connection Using Metalogix Extensions Web Service

The Remote Object Model connection allows Content Matrix to have a remote connection to the SharePoint on premises OM API through a SharePoint solution, which grants all of the same access for features and metadata that is available from the Local OM connection.

Required Permissions

Site collection administrator

When to Use

When the Metalogix Extensions Web Service (MEWS) is installed on the SharePoint farm

Okta authenticaton support

Supported* with the following limitations:

·Content Matrix SharePoint Edition only

·Must be used with Web Browser Authentication (which is not auto-detected)

NOTE: Because Okta requires web browser authentication, running a job via a PowerShell script and  Distributed Migration are not supported.

·Not supported for a connection that uses a proxy and/or certificate

EXCEPTION:  Okta supports the use of certificates for SharePoint 2010 only.  Refer to the article For SharePoint 2010 only: Import security certificate to Trusted Root Certificate Authority on the Okta website for details.

 

* Only connections to SharePoint 2016 have been tested by Quest.

Optimal Use Cases

·Migrating classic web parts

·Migrating Managed Metadata

·Migrating InfoPath forms

·Migrating List Template Gallery

·Updating site collection and navigation settings

·On the source farm:

§migrating alerts to SharePoint on premises

§migrating Audiences

§migrating Records Centers to SharePoint Online using the Import Pipeline

§migrating Workflows

·On the target farm:

·migrating Site collections, including site collection administrators

·migrating MySites

§migrating Master Page Gallery

§preserving Site themes

§preserving SharePoint List and List Item IDs

§preserving Authorship metadata

§migrating site quotas

§transforming list and site columns into a Managed Metadata column

Unsupported Operations

·Connecting to SharePoint 2019 in a FIPS-enabled environment

Client Side Object Model (CSOM)

The Client Side Object Model connects through the SharePoint CSOM. It is the only method for making site-level connections to SharePoint Online.  

Required Permissions

Site collection administrator

When to Use

When making a site-level connection to SharePoint Online

Okta authenticaton support

N/A

 

Optimal Use Cases

·Migrating Managed Metadata

·Migrating libraries that contain .aspx files, even if migration using the Import Pipeline is enabled

·Migrating OOB and SPD workflows

·Preserving major, minor, and draft versions of a document

·Preserving Web Part views (in most cases)

·Transforming list and site columns into Managed Metadata columns

Unsupported Operations

·Preserving list/library settings such as Quick Edit, Open document in browser, Launch form in a dialog and Allow items to be downloaded to offline clients

·Migrating Access request settings

·Preserving workflow instances

Office 365 Tenant Connection

The Office 365 Tenant connection works the same as a CSOM connection to an Office 365 environment, but since it connects at the tenant level it can also be the migration target for site collections, MySites, and Managed Metadata.

Required Permissions

SharePoint Administrator (and Site Collection Administrator for each target site collection in the Office 365 tenant environment)

Okta authenticaton support

N/A

Optimal Use Cases

From an on-premises source:

·Migrating Site collections, including site collection administrators

·Migrating Managed Metadata (This also requires the Term Store Administrator role)

·Migrating classic web parts

·Transforming list and site columns into a Managed Metadata column

·Miigrating MySites

·Migrating SPD workflow associations for lists and content types

·Preserving SharePoint list item IDs

Unsupported Operations

On the target:

·Preserving workflow instances

·preserving Web Part Views

·preserving major, minor, and draft versions of documents.

Connecting to SharePoint On Premises

Navigation:  Connecting to SharePoint >

Connecting to SharePoint On Premises

You can connect to SharePoint on premises by:

·making a read-only connection to a SharePoint database

OR

·by connecting to a SharePoint site or server at the farm, Web application, or site level.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating