Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - Blogs and Wikis Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Source Blog and Wiki Structure Connecting to a Source Blog or Wiki Connecting to SharePoint Preparing for Your Migration Initiating a Migration Configuring Copying Options Saving or Running a Migration Action Running Link Correction as a Post-Migration Task 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.Blog.Commands
Modifying Content Matrix Configuration and Settings Configuring Content Matrix for Distributed Migration Frequently Asked Questions About Us

Running Link Correction

Note that you may or may not want to extract links before running link correction.

To run link correction:

1.In Explorer View, select the SharePoint site collection or site for which you want to run link correction.

NOTE:  Link correction is only available at the site collection and site level.

2.Right-click and choose Link Correction > Correct Links to display the Correct Links Options dialog.

BW Content Links Options Dialog

3.On the Link Correction - General tab select the appropriate options:

a)Select the appropriate option for Link Correction Behaviour. Use the information in the following table for guidance.

If  ...

Then ...

you want to review what links would be corrected before the link correction is run

select Simulation Mode - Flag items with links to correct (Client-Side Only).

NOTE:  When you select this option, link correction will not actually be pushed through to the target.

you want to run the link correction

select Link Correction Mode - Correct items with links to correct.

b)If you want a Link Correction Report to be generated and saved to a CSV file:

§Check the Save links corrected to CSV file box.

§Select the location to which you want the CSV file to be saved.

4.On the Link Correction - Link Processing tab, select the appropriate options:

a)If you want the link correction to ignore any query string links that may be listed in the LinksCache.sdf file, check the Ignore query string in Source URL box.

b)If you want to replace matching text with a specified string:

·Check the Replace the following matching text in Source URL box.

·Select the appropriate option for Is Case-Sensitive?, then enter the Matching Text and Replacement Text (which may be a text string or a valid Regex expression).

NOTE:  You can enter as many Matching/Replacement lines as you would like. Use the [Tab] key to advance to the next line and the [Delete] key to delete a line.

BW Link Correction Link Processing

5.On the Link Correction - Contents tab, make sure the boxes corresponding to the SharePoint objects you want to include in the link correction process are checked.

BW Link Correction Options

6.If you want more detailed logging for some or all of the SharePoint objects on which the link correction will be run, switch to the Logging tab, check the Enable verbose logging box then check the appropriate options.

BW Link Correction Logging

Now you can save or run the action.

When the action starts, a Job log will be created. The logs can be viewed (in progress or after the action is finished) by clicking [Details>>]. After the action has completed a note will be displayed in the bottom left corner of the dialog stating the number of completions, as well as any warnings or errors that may have been encountered (if there were any).

Log Files

You can view the progress of a migration tab in real-time via interactive log files. The logs are fully searchable, and are based on SQL Compact Edition (SQL CE) file types. The log files are tied into Job files (.LST), and these files are limited to 4GB in size.

To view an interactive log:

After starting an action, click Details>> in the progress dialog box.

NOTE:  All logging in Metalogix Content Matrix is done through jobs. If a job list is deleted from the Jobs List, all logging for those actions will also be deleted. There is no backup for the job lists, unless the job is manually saved to another location. Once a job list is deleted, all logging for the actions within that job list are gone. Metalogix Content Matrix will automatically hold any job lists created through any copy or compare actions, in the Job Lists section, and these job lists can only be deleted through the appropriate Delete commands. The job lists can also be manually selected and saved through the Job list section.

There are two types of jobs in Metalogix Content Matrix:

A job list is a collection of job items. A Job list is created for each copy or compare action that is made. Any "Copy" action/job that is in the Job List section can be used as the base of an incremental copy job. Job items can be viewed in the Log Viewer, by opening a job list. There are three basic ways to open a job list to access the Log Viewer:

·Double-click on a job list.

·Select a job list, then in the Job List section of the toolbar click View Log.

·Select a job, right-click, and choose View log.

Job items are job files, or logging, for individual items within the scope of an action. For example, if a Confluence site is copied, there would be a job item for adding each SharePoint list and each item in that job list, and one job item for adding or creating each site or sub-site. If a Confluence site with 5 blog posts is copied, then there would be a job item for adding/creating the list on the target, and then one job item for adding each of the posts.

Log Viewer

Job items are job files, or logging, for individual items within the scope of an action. For example, if a SharePoint site is copied, there would be a job item for adding each list and each item in that list, and one job item for adding or creating each site or sub-site. If a SharePoint list with fie documents is copied, then there would be a job item for adding/creating the list, and then one job item for adding each of the documents.

From the Log Viewer you can select and view any job items that exists within that job list.

NOTE:  Some actions in Metalogix Content Matrix have the ability to run with Verbose Logging. This option will increase the size of the log file.

Log Item Details

To view Log Item Details:

1.From the Log Viewer, select the item whose details you want to view.

2.Use one of the following options:

§Double-click on the item.

OR

§Right-click and choose View Job Item.

OR

§If the job is currently running, click Details>>.

LogDetails

The Job Details dialog contains the following information:

·Operation - The last operation performed on the item.

·Status – The status of the item. If a compare action is being performed then this could be: completed, different, or missing.

·Item Name - For items, the Item ID. For documents, the Filename.

·Time Started – The time the action for the item was started.

·Time Finished – The time the action for the item was finished.

·Bytes Copied – The  bytes (B) that were copied in the action. This will be displayed in KB in some cases.

·Source - The Source URL for the item.

·Target - Target URL for the item.

·Information - Provides an informational message about the item, such as. This section will provide a description for any different and/or missing attributes/metadata for an item.

·Details View - Any errors that were encountered with the item when an action was performed.  

·Content Comparer tab - Any differences between Source and Target content (from a compare action). You can display this information in either a Grid View, which displays a metadata property grid for the item, or as a Text View, which displays a XML text format of the item.  This option is most useful if Verbose Logging has been checked

You can also:

·Use [Copy] to copy all of the item information and details (including the Details tab) into the system’s clipboard.  You can then paste the information when it can then be pasted to another location. When pasted the information will look similar to that of the actual Log Item Details dialog. This can be used for easy copy/pasting of an items migration log details.

·Use [Prev] and [Next] buttons to move to the previous or next item on the list (if applicable).

Exporting Jobs to an Excel File

You can export a selected job or multiple jobs from the Job List section into a Microsoft Excel file. The export will include all of the operations within each job (whether it is a migration action or some other action), and their details. This is to help users better understand their migration data and results, and provides another way to review the resulting logs.

In addition to the log details that are provided, there are also a number of tables and charts that can be accessed in different tabs within the Excel file. These tables and charts will help breakdown the information in a more visible manner.

To export one or more jobs to an Excel file:

1.In the Jobs List, select the job(s) you want to export.

2.Use one of the following options:

§From the Jobs List menu, select Export Excel

OR

§Right-click and choose Export selected job to Excel.

3.Save the file to the desired location.

By default the Excel file will open after it has been created. This process may take a few minutes depending on the size of the selected job(s) and the number of actions in the log(s).

Related Documents