Metalogix Content Matrix - eRoom Edition uses a Link Dictionary database to store a list of mappings for link correction. This database is populated through the use of the Link Correction Options tab when configuring a migration, and as a post migration option.
The first method to manage the Link Dictionary is through the use of the Settings heading in the ribbon menu, which includes the following options:
·Export Link Dictionary - This option will create a CSV file containing a list of all of the current URL mappings between the eRoom source and the SharePoint target. The CSV will contain two columns, Source URL and Target URL. Selecting this option will open the Link Dictionary Export Options dialog.
If you want Metalogix Content Matrix to output a CSV file containing a list of any of the links that were corrected by the link correction action, enter a file name in the text box, then click the folder icon and navigate to the location where you want to save the CSV file.
Then you can save or run the CSV creation action.
·Clear Link Dictionary - This option will delete any link mappings that currently exist in the Link Dictionary database file. When selected a warning dialog will open to confirm that the links should be cleared.
The second method is through a manual process. The database file that is used for the link mapping can be found at the following location:
[Drive]:\Users\[USER]\AppData\Roaming\Metalogix\Metalogix Content Matrix Console - eRoom Edition
In this folder, the LinksCache.sdf file is a database file that contains the link mappings.
NOTE: If using this method, the Metalogix Content Matrix Console should be closed/shutdown before editing/accessing any files in this folder location.
If you want to remove all the existing mapping, and are not able to use the Settings > Clear Link Dictionary method, you can navigate to this folder location and delete the LinksCache.sdf file, then restart the Metalogix Content Matrix Console.
You may also want to clear any existing link mappings, but do not want to permanently lose the existing mappings. In this case the current LinksCache.sdf file can be renamed and saved, and a new LinksCache.sdf file can be created. All of the existing mappings will still exist in the renamed file, and new mappings can be created in the new file. Should you want to switch back, you can rename the newer version of the file, and return the original file back to its original file name, LinksCache.sdf.
Metalogix Content Matrix lets you run an incremental migration (also known as a delta migration or an incremental copy) to migrate new and updated data from the source to the target. This can save time when relatively minor changes have been made to a large source environment, and you want to migrate those changes to your target environment.
Incremental migrations are based off previous migration actions. In order to create an incremental job, a non-incremental migration action must have already been run, and a job item for that action must exist in the Job List.
Incremental migrations can be run from the Metalogix Content Matrix Console UI or through a PowerShell script.
Prerequisites and Limitations of Incremental Migrations
·To run an incremental migration, a full migration must have already been run for the content you want to migrate incrementally. This is because of the following: firstly, there must be content on the target environment to compare changes on the source environment against, and secondly, incremental migrations can only be created from an existing job item in the Job List.
·The only supported connection types are Local Connection (SharePoint Object Model) and Remote Connection (Metalogix SharePoint Extensions Web Service). For more information about connection types, please see Connecting to SharePoint.
·Incremental migration works by comparing the last modified dates for each item on the source and target. Therefore, the following scenarios do not fully support incremental migration:
§If an item on the source is moved after the initial non-incremental migration action, it is considered a new item and is migrated incrementally. This will result in duplicated items.
§If an item on the source is deleted after the initial non-incremental migration action, there is no longer a last modified date on the source to compare to the target. This will result in the deletion not being detected by Metalogix Content Matrix Console, which means that the deleted item on the source remains on the target after the incremental migration action.
·Only Title and Description eRoom metadata is supported. Other metadata types are not supported because they have no equivalent object in SharePoint.
·It is a Known Issue that an incremental migration action will incorrectly duplicate eRoom objects if:
1.A set of eRoom objects is migrated non-incrementally to a subsite on the target.
2.That same set of eRoom objects is then migrated non-incrementally to a different subsite on the target.
3.An incremental migration job is then created from the non-incremental migration action that was created in step 1.
NOTE: This issue applies to all eRoom object types and migration actions that support incremental migration.
Supported Incremental Migration Actions and Objects
The following is a list of migration actions that support incremental migration:
·Paste as Document Library (except when migrating calendars, discussions, and polls)
·Paste as Site
·Paste all Items As Site
·Paste as Site Collection
·Paste as Site Collection using Nested Object Flattening
·The following object-specific migration actions:
§Paste Calendar and Paste Calendar Event
§Paste as Database
§Paste Discussion and Paste Discussion Topic
§Paste Document, Paste Container as Folder, and Paste Folder > All Items
§Paste as eRoom Link and Paste Link as Link to a Document
§Paste as Poll
The following is a list of eRoom objects that support incremental migration:
·Discussions (known as Discussion Boards in SharePoint)
·Metadata (only 'Title' and 'Description')
·Polls (known as Surveys in SharePoint)
To migrate eRoom Content Incrementally:
1.Ensure that a non-incremental migration action has already been run for the content you want to migrate incrementally.
2.In the Job List, select the existing job item.
3.Right-click and choose Create incremental job.
A new incremental job is added to the Job List.
4.If you want to change the configuration options for the incremental job:
§In the Job List, navigate to the incremental job:
§Right-click and choose Change configuration for selected job to display the Copy Container As... dialog.
5.Change any configuration settings as you would if you were configuring copying options for a full migration.
§In the Migration Mode tab, the Incremental Copy option is selected, and all other options are disabled.
§In the Collision Options tab, the Use existing content option is selected, and all other options are disabled.
Now you can save or run the action.
You can view the progress of a migration tab in real-time via interactive log files. The logs are fully searchable.
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 Job 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 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 five 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.
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.
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.
§Right-click and choose View Job Item.
§If the job is currently running, click Details>>.
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 systems 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).