Migrator for Notes to SharePoint 7.1 - User Guide

Migration job logging

Your migration job log contains more or less detail, depending on the logging options you have set. If you are running Migrator for Notes to SharePoint Designer, you can also change the file folder that log files are saved to. See Customizing global options for more details. If you are running your migrations through the Console, your log is written to the repository and can be viewed and exported from the Task history node or the Migration History tab of the Database Properties sheet.

The General tab of the Event Log dialog box displays basic migration job information. To display more information, click the arrows on the upper right side of the tab. Click the arrows again to close this detail.

To export the log to an XML file, click Export Log.

To open the target SharePoint list, click Go to List.

The Log Summary tab of the Event Log dialog box displays the processed records of the migration job. While the migration job is running, this information is automatically updated every 3 seconds.

In the processed records list, if the message column is not wide enough to fit the text, hovering over a row will show a tool tip with the complete message.

To view the details of a processed record, select it in the table and click View Details.This opens the Log Entry Details dialog box.

To navigate to a previous entry, click <Prev and to navigate to the next entry, click Next>.

For a processed record of error type, you can click Search for solution to search the Context and Message texts of the record from the product Knowledge Base, and display the results in a new window, where you can preview the titles of those relevant articles. To show a snippet of a knowledge article immediately, hover your mouse over the title, or click the title to read the complete knowledge article in your browser.

To copy the entire entry to the clipboard, select Copy to Clipboard. You can then paste the contents into an editor of your choice.

To open the document for the given log entry in the source Notes database, select Open in Notes.

Select Close to close the Log Entry Details dialog box.

To view the log details for a migrated document, select the document in the Log Summary tab and click the Show in Log button on the right side of the tab. This will take you to the line item in the Log Details tab that represents the migration of the selected document.

The Log Details tab contains the detail line items of the log file. While the migration job is running, this information is updated by clicking the Refresh link in the upper left side of the tab. This link is only visible while the job is processing.

NOTE: The refresh link is not available when viewing a running job through the Task History node of the Console.

The data can be sorted by clicking on the column heading you want to sort by.

You can open the Log Entry Details dialog box by double clicking a row in the table.

The Duration column shows how long each task takes to complete. To view the tasks that are taking the longest, sort by this column.

For migration jobs that have been run using Migrator for Notes to SharePoint Designer or the Command Line, the logs can be imported into the Console. This allows the jobs to be visible in the database’s migration history tab.

See Importing tasks for details.

To open log files from prior jobs, you can select Open Log File from the File Menu. And if any items failed to migrate according to the log, click Migrate Failed Items to migrate them again. For more information, see Migrating failed items.

Latest Log File will open the log from the last time a job was run and Recent Log Files allows you to choose from a list of logs of the most recent run jobs.

Managing migration jobs

Migrator for Notes to SharePoint Jobs consist of the following:

In other words, everything you entered on the "Notes", "SharePoint" and "Map Data" tabs combine to make a Job Definition.

For an ad-hoc data migration job, you never need to save Job Definitions to disk. However, there are several reasons you might want to save a Job Definition:

To save a Job Definition, click the Save Job button.

To load a Job Definition, click the Load Job button.

To dispose of the current Job Definition and start a new one, click the New Job button.

Migrator for Notes to SharePoint Job Definition files are formatted as XML text. For details on this format, see Job definition file format .

Appendix: Reference information

Notes connection string reference

Migrator for Notes to SharePoint connection strings are used when opening connections to Notes or Domino databases. The syntax takes the form of one or more "parameter=value" declarations separated by semicolons. For example:

Specify the Database or ReplicaID and optionally the Server parameters for the database to connect to. If both the Database and ReplicaID are specified, or if the AltServer is specified, multiple attempts to connect will be made before giving up.

Connection parameter names are not case sensitive; "Server" and "server" are equivalent.