Chat now with support
Chat with Support

Metalogix Content Matrix 9.2 - SharePoint Edition User Guide

Introduction Entering the License Key Metalogix Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint Migrating to SharePoint Online Using the Import Pipeline Preparing for a Migration How Content Matrix Handles Various SharePoint Components
How Team Sites are Migrated to SharePoint Online and SharePoint 2019 How Master Pages are Migrated How List Template Galleries Are Migrated How Content Types are Migrated Document Version and Checked Out File Limitations How Ghosted and Un-Ghosted Pages are Migrated How Records Centers are Migrated to SharePoint Online Using the Import Pipeline How Document Sets are Migrated How Navigation is Migrated How MySites are Migrated How Managed Metadata, Terms, and Term Stores are Migrated How "Share With" Metadata is Migrated to SharePoint Online Using the Import Pipeline How Web Parts are Migrated How Site Themes are Preserved How Site Features Are Migrated How Users and Permissions are Migrated How BCS/BDC Data is Migrated How OneNote Notebooks are Migrated How Customized Form Pages are Migrated How InfoPath Forms are Migrated How SharePoint Workflows are Migrated How Nintex Workflows and Forms are Migrated How Link Correction Works
Initiating a Migration Configuring Copying Options Saving or Running a Migration Job Copying SharePoint Objects as a Separate Action Incremental Migration 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 Migration Frequently Asked Questions About Us

Managing Agents

From any agent machine, you view, refresh and disable/enable job execution.

NOTE:  All agents connecting to the same Distributed Database must have the same version of Content Matrix installed.

To open the Manage Agents dialog:

From the Metalogix Content Matrix Console ribbon, choose Connection > Manage Agents.

NOTE:  If the machine is not connected to a configured Distributed Database, Manage options will be disabled.

Manage Agents Dialog

The Manage Agents dialog presents a toolbar with the following options:

·View Agent - Displays more information about a selected agent or workstation such as log history, and other pertinent information.

Agent Details

·Refresh - Displays the most recent status of a selected agent.

·Disable Job Execution  - Prevents the agent from pulling migration jobs from the Distributed Database.

NOTE:  If you want to uninstall the agent completely, use the procedure for Uninstalling a Distributed Migration Agent.

Uninstalling an Agent

To uninstall an agent:

1.Log into the machine using an Administrator account.

2.Open a Command Prompt using the Run as Administrator option.

3.Change the directory to point to the location containing the Agent Service files.  (C:\Program Files (x86)\Metalogix\Agent Service is the recommended default location, but the files may be in a different location.)

Command Prompt Agent Service

4.Run the following command:

Metalogix.Agent.exe -u

5.Uninstall the Content Matrix Console.

Frequently Asked Questions

This section answers some of the most frequently asked questions about using Metalogix Content Matrix.

DB_Owner Permission

Question

Are read and write permissions to the SharePoint content database sufficient for the Metalogix Extensions Web Service to perform migration?

Answer

As you may know, the Metalogix Extensions Web Service requires read and write permissions to the Content Database, according to a Microsoft KB article (http://support.microsoft.com/kb/935751. However, this is only a solution if you have encountered the message "Unhandled Exception: system.IO.FileNotFoundException" when using the SharePoint object model. We have found that few users have reported this issue, since the Web Service account is usually granted the sysadmin server role, which has complete control over all database functions.

After some internal testing we have determined that the Web Service installing account requires more than read and write permissions to function without database errors.

1."db_owner" rights to the SharePoint Content Database is required.

If the Web Service account does not have the db_owner right to the SharePoint Content Database, Metalogix Content Matrix will not be able to migrate list items using the Web Service, and may receive one of the following errors:

4/19/2010 7:13:53 PM Error copying list item: 1/1 (id: 1, title: Get Started with Windows SharePoint Services!): Service Error: [MLSPService could not add items: MLSPServiceMethods.AddListItems() Failed: Cannot open database "WSS_Content" requested by the login. The login failed.

4/20/2010 10:21:01 AM Error copying list item: 1/2 (id: 1, title: Get Started with Windows SharePoint Services!): Service Error: [MLSPService could not add items: MLSPServiceMethods.AddListItems() Failed: Operation aborted (Exception from HRESULT: 0x80004004 (E_ABORT))

2."db_owner" or "WSS_Content_Application_Pools" rights to the SharePoint Admin Content Database is required.

If the Web Service installing account does not have db_owner or WSS_Content_Application_Pools rights to the SharePoint_AdminContent, Metalogix Content Matrix will not be able to create/paste site collections, and will receive an error.

With these cases in mind we have determined that the Metalogix Extensions Web Service account should be granter the db_owner permission rights, at a minimum, to allow Metalogix Content Matrix to correctly migrate content to the target SharePoint instance.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating