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

Scheduling a Migration Job via the Windows Task Scheduler

If you chose the Generate PowerShell Script option (that is, to configure the migration job directly in the Windows Task Scheduler) and saved the PowerShell script to the location of your choice, follow the steps below.

1.On the system where the scheduled task will run, open the Windows Task Scheduler.

2.Choose Actions > Create Task.

3.Enter a task Name and Description.

4.In the General tab, go to Security options and specify the user account that the task should be run under. Change the settings so the task will run regardless of whether the user is logged in.

5.Select the Triggers tab, and click [New] to add a new trigger for the scheduled task. This new task should use the On a schedule option. The start date can be set to a desired time, and the frequency and duration of the task can be set based on your specific needs. Click [OK] when your desired settings are entered.

6.Select the Actions tab and click [New] to set the action for this task to run. Set the Action to Start a program.

7.In the Program/script box enter "PowerShell."

8.In the Add arguments (optional) box enter the value ".\[Your PowerShell Script Name]." For example, if your PowerShell Script is named "Migration1.ps1" then you would enter ".\Migration1.ps1" as the value.

9.In the Start in (optional) box, add the location of the folder that contains your PowerShell script.

NOTE:  The location used in the Start in box will also be used for storing the scheduled task run times, the job history for the copies, and any additional logging that may occur.

10.When all the desired settings are made, click [OK].

11.Next, set any other desired settings in the Conditions and Settings tabs. You can also set up additional actions, such as emailing an Administrator each time the script is run.

12.Once all the desired actions have been made (or added), click [OK].

The task will be immediately set, and is ready to run.

Refreshing the Jobs List

NOTE:  The refresh is applied to whichever job list Metalogix Content Matrix is currently connected to, whether that is the Agent Database (for the Distributed Migration feature) or via a standard connection.

To refresh the jobs list:

1.From the Manage Queue dialog, select a job in the Job List.  The row selector icon and the highlighted row indicates the selected row.

2.From the Jobs List menu bar, choose File > Refresh.

If the status of the job has changed, the Status value will indicate the new status of the job.

Submitting a Distributed Migration Job

If the Metalogix Content Matrix Console is configured as the Controller (Host) for Distributed Migration, you can submit a Distributed Migration job.

Distributed Migration Job Limitations

Connection icon

· If a migration job is using SP 2013 DB as a source connection, then users can only run jobs remotely on an Agent that meets the SP 2013 DB connection requirements. - If using a SharePoint 2013 Database connection on the source, then the Agent machines must also meet the requirements for connecting to a SP 2013 Database. This means that, like the Host machine, the Agent machines must either:

§Have SharePoint 2013 installed on the or be a SharePoint 2013 WFE.

OR

§Be a 64-bit machine that has no version of SharePoint installed on it.

·Local OM connections to SharePoint are not supported when using Remote Agents. - A Local OM connection to SharePoint can only be made when Metalogix Content Matrix is installed on a machine that is running SharePoint (a SharePoint server or WFE). Since this type of connection can be made on the Host machine, but cannot be guaranteed to also be available on an Agent machine, it is not a supported connection adapter for running migrations using remote Agents.

 

·Connections to SharePoint Online must be made using accounts that do not use Multi-Factor Authentication or "modern" authentication - Because the Distributed Migration model relies heavily on PowerShell to perform migrations without user intervention, Web Browser Authentication cannot be used.  Therefore, connections to SharePoint Online must use an account that is not part of a SharePoint Online Multi-Factor Authentication policy and does not use "modern" authentication, because these authentication methods require Web Browser Authentication.

·Transformer scripts will not work using a Remote Agent if the script is used as an attachment (i.e. if the script is stored as a file on the local file system, and added to the migration configuration as an attachment) - When running a migration, uses can go to the 'Transformations' tab in the configuration options and set the migration to use a transformer. If the transformer is added by using the Invoke PowerShell script > Use Script From File option, then the transformer will be added by selecting a script file from the file system and attaching it to the configuration options. Transformer script files that are attached in this manner do not get transferred to the Agent machines, so when the Agent tries to run the migration it will run without the configured transformer script.

·If an action in Metalogix Content Matrix is not supported for generating/running the action over PowerShell, then that action is not supported to run remotely on an Agent machine. - Not all actions in Metalogix Content Matrix are supported when using PowerShell. Since running a migration on a remote Agent relies on PowerShell, some actions are not supported to be run remotely. For example:

§Copy Site > Paste Site Objects > List E-mail Notification

§Copy Site > Paste Site Objects > Managed Metadata Local Site Collection Group

§Copy Site > Paste Site Objects > Managed Metadata Term Store

§Copy Site > Paste Site Objects > Site column

§Copy List > Paste List Objects > Permission

Related Documents