Migrator for Notes to SharePoint 7.4 - User Guide

Migration jobs

Running migration jobs

When you are ready to run your migration job, select Run. You can do this by selecting the Run toolbar menu or by clicking the Run button at the bottom of the Designer or the Migration Jobs tab of the Console’s Database Properties dialog box. This button is a split function button. If you click the left side of the button, the entire migration job will run. The right side of the button is a drop down menu that allows you to run portions of the job like provisioning.

Figure 13. Run provisioning only

If you have access to both SharePoint and Notes on your machine, or if you are connected to a remote SharePoint server running Migrator for Notes to SharePoint's Import Service, you can run a complete data migration job all at once. Otherwise, you need to export the intermediate results to an XML file from Notes and then import intermediate results from an XML file into SharePoint. The following is an example of how you might use the export/import:

If you choose to use an intermediate data transfer file, you should also save the matching Job Definition. See Managing migration jobs for more details.

From the Console, you can select multiple databases, right-click, and select Migrate to SharePoint.

To view detail information regarding the jobs before you run them, click the Details link.

If you choose Save to Intermediate File, a dialog comes up that gives you an option to have the attachments saved to a separate folder rather than the default of the intermediate data file.

There are a couple of benefits to saving the attachments in a separate folder:

When you choose to save attachments and generated documents to a separate folder, Migrator for Notes to SharePoint uses the correct file names wherever possible when the attachments and generated documents (but not images) are saved to the file system.

The name of this separate folder is derived from the name of the intermediate data file with "_Files" appended. The name or location of this shared folder cannot be changed. You can move the intermediate file and its corresponding folder, but you cannot rename them, and they must remain in the same relative location to each other (that is, When reading "journal.xml" we expect that the "journal_Files" folder will be in the same directory as "journal.xml").

You should see your progress displayed in a task process dialog box. If you are using the Console and chose to run the job in the background, you can find the task process dialog box in the Task history node of the tree.

To cancel the migration, click Cancel Task or close the dialog box.

When your job is complete, you will have the opportunity to view your log file or go directly to the SharePoint list or library by clicking Go to List. To migrate the failed items for a job that completed with error, click Migrate Failed Items. For more information, see Migrating failed items.

Migrating failed items

You can load the failed items from the log file after changing the relevant settings, and migrate them again.

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.