Migrator for Notes 20.14.2 - User Guide

Drop Users From Migration Groups with Excel

Account entries can be removed from Migration Groups in the Migrator for Notes application through an Excel spreadsheet import process. The Migration Group for the accounts will be changed back to the No Migration Group Set status.

The Excel spreadsheet should have the first column configured with either the Internet Address or the Short Name to locate the account entries that need to be updated. The import process is the same as the Import Selected Users From Excel option.

Appendix D: Item Processing Results

The following results are returned for individual items when migrating and are recorded in the migration log:

• Success – Processing of item completed as expected and the corresponding item was created or updated in Exchange

• Error – A serious failure in processing the item/user has occurred.  Possible failures include:

  • Failed to open Source Mail file, DB information or a Document

  • Failure to get Document counts from collection

  • Initialization failures (missing settings files, templates, and so on)

  • No documents selected by filtering to be processed

  • Critical fields missing from documents  

• Warning – Unusual data or condition exists, but the item may have been processed. Log entries of the minor issue are provided

  • Examples include missing fields in Notes or invalid data

  • Some warnings may later be reported as errors if the missing data has no alternates and processing of the item cannot continue

  • The item is marked as processed

• Skipped – The Item cannot be processed due to filtering, bad data, duplicate of previously processed item, and so on; skipped items will no longer return a warning or error

  • The item is not marked as processed

• Notification – Processing of an item completed but an informational detail was recorded based on migration settings.

  • A  source attachment exceed the set size on the Settings | Other Settings for processing in the MIME Stream and the attachment was processed and migrated separately to the message body.

Appendix E: Migration Result Statuses

The following results are returned to the migration controller server for the overall migration status of all items:

• Migrated Successfully – Completed processing all items, no problems during initialization, no critical errors encountered; there may be non-critical Warnings, Errors or failures during individual document processing, but these do not stop the migration; the migration will still be considered successful even if there are document warnings or errors

• Migration Failed – Critical errors/failures encountered that prevent the migration from continuing/completing; this status is typically caused by network/server connectivity problems

• Terminated Abnormally – This status is set by the migration worker when CMTProxy.exe (migration engine) crashes; this is typically caused by corrupt source data, a Notes client crash or Exchange terminating the migration connection

• Failed to Initialize – Incorrect/Incompatible configuration settings, missing configuration or reference files, failure to connect to source or destination servers, and so on; no data is migrated

• Migration cancelled – Manual cancellation of the migration the user

• Not Queued: Migration history is pending update – The migration was not started due to the history of a previous migration not being updated

• Migration failed: Exchange is not available – The migration failed because Exchange was not available

• Nothing in Source File – The source mailfile is able to open but does not contain any data

• Source Database Not Initialized – The source mailfile fails to open with “Database Not Initialized”

• AutoDiscover Failure – The Target mailbox fails to connect with Autodiscover

• No License – The migration was not processed as there were no available licenses to apply to the entry.

   

Set Migration Status

To manually update the status of migrated items, follow the steps below.

1. Expand the Migration | Advanced view; select rooms and resources in the Data Pane

   

2. At the top menu, click Actions | Other; the Run Agent dialog box will open

3. Select Set Migration Status and click Run:

   

4. From the Set Migration Status dialog box, then, for example, select Ready to Process and click OK:

   

5. A status message box displays showing that the migration status will be changed for the selected rooms; click Yes to confirm

   Notice that the selected rooms and resources are now listed under the applied status:

   

Set Migration Group

1. At the top menu, click Actions | Other; the Run Agent dialog box will open

2. Select Set Migration Group in the dialog box and click Run:

   

3. Specify the migration group name in the Migration Group dialog box and click OK:

   

6. A status message box displays showing that the migration group will be changed for the selected rooms; click Yes to confirm

   Notice that the selected rooms and resources are now listed under the applied status:

   

Set Migration Workstation

1. At the top menu, click Actions | Other; the Run Agent dialog box will open

2. Select Set Migration Workstation in the dialog box and click Run:

   

3. From the Set Migration Workstation dialog box, select a workstation on which to run the selected users’ migrations, and then click OK:

   

4. A confirmation box appears; click Yes to confirm that you want the selected migration workstation to be set for selected rooms and resources

5. A status message box displays showing that the migration workstation will be set for the selected rooms; click Yes to confirm

   Notice that the selected rooms and resources are now listed under the applied status

Clear Migration Status

1. In the same way, you can clear set migration status, migration group, and migration workstation by selecting appropriate options; if you do not set the migration workstation manually, Migrator for Notes will automatically farm the migration job out to the next available worker in the migration farm

2. Select the rooms and the resources, then click the Additional Actions button to display its drop-down menu options:

   

   The drop-down menu options are as follows:

3. After you have performed all the pre-migration actions on the rooms and resources, go back to the Migrate view

4. Select all the rooms and resources you wish to migrate then click the Migrate Rooms & Resources button in the Data Pane toolbar

5. The Select Migration Priority dialog box appears; click OK to trigger the migration:

   

   Depending on the size of the data being migrated, the transfer may take from few minutes to several minutes

6. The Refresh Migration Status button allows you to refresh the status of the selected rooms and resources

    

Set Migration MCC

In some cases, you have the option to set the Migration MCC. Refer to the chart below for a description of these MCC options:

Set Migration Status

The following results are returned to the migration controller server for the overall migration status of all items:

• Migrated Successfully – Completed processing all items, no problems during initialization, no critical errors encountered; there may be non-critical Warnings, Errors or failures during individual document processing, but these do not stop the migration; the migration will still be considered successful even if there are document warnings or errors

• Migration Failed – Critical errors/failures encountered that prevent the migration from continuing/completing; this status is typically caused by network/server connectivity problems

• Terminated Abnormally – This status is set by the migration worker when CMTProxy.exe (migration engine) crashes; this is typically caused by corrupt source data, a Notes client crash or Exchange terminating the migration connection

• Failed to Initialize – Incorrect/Incompatible configuration settings, missing configuration or reference files, failure to connect to source or destination servers, and so on; no data is migrated

• Migration cancelled – Manual cancellation of the migration the user

• Not Queued: Migration history is pending update – The migration was not started due to the history of a previous migration not being updated

• Migration failed: Exchange is not available – The migration failed because Exchange was not available

• Nothing in Source File – The source mailfile is able to open but does not contain any data

• Source Database Not Initialized – The source mailfile fails to open with “Database Not Initialized”

• AutoDiscover Failure – The Target mailbox fails to connect with Autodiscover

• No License – The migration was not processed as there were no available licenses to apply to the entry.

   

To manually update the status of migrated items, follow the steps below.

1. Expand the Migration | Advanced view; select rooms and resources in the Data Pane

   

2. At the top menu, click Actions | Other; the Run Agent dialog box will open

3. Select Set Migration Status and click Run:

   

4. From the Set Migration Status dialog box, then, for example, select Ready to Process and click OK:

   

5. A status message box displays showing that the migration status will be changed for the selected rooms; click Yes to confirm

   Notice that the selected rooms and resources are now listed under the applied status:

   

Set Migration Group

1. At the top menu, click Actions | Other; the Run Agent dialog box will open

2. Select Set Migration Group in the dialog box and click Run:

   

3. Specify the migration group name in the Migration Group dialog box and click OK:

   

6. A status message box displays showing that the migration group will be changed for the selected rooms; click Yes to confirm

   Notice that the selected rooms and resources are now listed under the applied status:

   

Set Migration Workstation

1. At the top menu, click Actions | Other; the Run Agent dialog box will open

2. Select Set Migration Workstation in the dialog box and click Run:

   

3. From the Set Migration Workstation dialog box, select a workstation on which to run the selected users’ migrations, and then click OK:

   

4. A confirmation box appears; click Yes to confirm that you want the selected migration workstation to be set for selected rooms and resources

5. A status message box displays showing that the migration workstation will be set for the selected rooms; click Yes to confirm

   Notice that the selected rooms and resources are now listed under the applied status

Clear Migration Status

1. In the same way, you can clear set migration status, migration group, and migration workstation by selecting appropriate options; if you do not set the migration workstation manually, Migrator for Notes will automatically farm the migration job out to the next available worker in the migration farm

2. Select the rooms and the resources, then click the Additional Actions button to display its drop-down menu options:

   

   The drop-down menu options are as follows:

3. After you have performed all the pre-migration actions on the rooms and resources, go back to the Migrate view

4. Select all the rooms and resources you wish to migrate then click the Migrate Rooms & Resources button in the Data Pane toolbar

5. The Select Migration Priority dialog box appears; click OK to trigger the migration:

   

   Depending on the size of the data being migrated, the transfer may take from few minutes to several minutes

6. The Refresh Migration Status button allows you to refresh the status of the selected rooms and resources

    

Set Migration MCC

In some cases, you have the option to set the Migration MCC. Refer to the chart below for a description of these MCC options: