Hidden Gems: Part 1 - #LotusNotes Migration

Our solutions have migrated MILLIONS of mailboxes over more than a decade. Through the years, numerous customizations have been made for specific customers and/or general use. Unfortunately, all of the available options could not possibly be included in the interface. As a result, we offer very flexible migration solutions AND, in the case of Notes Migrator for Exchange (NME), 186 pages of program parameter goodness.

On the other hand, this can also make it more difficult for customers and partners to know the available options and understand when they may be advantageous.

In this series of posts, I will reference some of the settings I have found valuable in the past and some of the newer options available in our solutions. I will attempt to categorize them by scenario and function to highlight when they may be most beneficial.

Feel free to download the full Program Parameters Reference Guide (a.k.a. INI Reference Guide) from the website, follow along, and comment on other settings you have found beneficial. Each setting will be listed in the format of "[Section] Setting" for easy reference.

Migration Prep & Config

[Notes] CustomAttr=<#> - Used to extract custom attributes from the Domino Directory. This can be very useful when matching Notes users to existing Active Directory objects and for building collections of users for migration.

[ActiveDirectoryMatchList] ADML=<AttribName> and [ActiveDirectoryMatchList] Count=<#> - These settings can be used in combination to update the Active Directory attributes available in NME's Provisioning Wizard. This is helpful if you need to use a non-standard attribute when merging / matching objects.

[General] UserFilteredAttachmentMsg and [General] AttachmentLostDueToEncryptionMsg=<PathAndFilename> - Long names...amazing results. :-) These are used in combination to replace any encrypted attachments with a text file. The text file can be customized to include any information you want to provide the users. I highly recommend including a link to the Self-Service Desktop Migrator configured for Silent Mode, which I will cover in more detail in a future post.

[General] UserFilteredBodyMsg and [General] BodyLostDueToEncryptionMsg=<PathAndFilename> - These are corresponding settings for encrypted message bodies. Typically, the attachment and message body settings will both be configured.


[Exchange] RemigrateMode=<#> - By default, NME checks the target mailbox and will not remigrate items. This setting provides an option to overwrite (i.e. remigrate) any previously migrated items.

[Exchange] O365UsageLocation=<xx> - This is new for NME 4.7 and required when automating Office 365 licensing through NME.

[Exchange] MAPIErrorsToRetry=<######> - During some migrations, connectivity and other transient issues can impact processing. This setting, along with other available retry settings, allows you to tune the retry logic to meet the specific needs of the environment.

[ErrorsToIgnore] - This section of the Global Default Settings provides an opportunity to customize the errors reported to the log files. After reviewing errors and warnings during the initial migrations, it may become apparent that some of the items are expected and should be excluded from future logging. This can be valuable in simplifying the log analysis and review process.

Test Migrations & POCs

During the testing phases of projects, you may be looking for quick results or just attempting to prove out the migration process. There a several settings that may be very useful in these cases:

[Notes] Offline=<#> - This setting is extremely valuable in lab environments and disconnected scenarios.

[DirectoryExport] SkipCatalogSearch=<#> - If you are not running completely offline, disabling catalog searches can dramatically speed the export of the Domino Directory.

[DirectoryExport] SkipGroupMembers=<#> - If your tests are focused on user migration, this setting can save additional time during the Domino Directory export.

[DirectoryExport] GenerateAliases=<#> - For test migrations and many production migrations, it is not necessary to generate aliases for all possible addresses Notes would accept. As a result, it is often beneficial to deselect most of the Internet Domains within the NME configuration or use this setting to turn off that feature.

[ActiveDirectory] MBoxFromContact=<#> - If Active Directory is populated with contacts representing the Notes users, but not user objects; this setting can force NME to build mailboxes directly from the existing contacts. This can save several steps in the migration process - especially during test migrations.

[General] ACLs=<#> - One of the great features of NME is the conversion of ACLs and Delegates to corresponding rights. However, this also requires all of the users to be present in Active Directory. During test migrations, Active Directory may not be fully populated, so it may be advantageous to disable this feature temporarily.

[Exchange] ArchiveResolveAttendees=<#> and [Exchange] ServerMailResolveAttendees=<#> - These settings can be used to stop lookup attempts to the Exchange server, which is beneficial for offline migrations and tests to PST files.

Customizing Processes & Results

[ArchiveData] UsePseudoRoot=<#> - By default, archive data is migrated under a root or subfolder to distinguish it from data from the primary Notes mail file. In some circumstances, organizations want to consolidate the data from both sources into a common folder structure. In those instances, this setting can save considerable effort after the migration.

[Notes] DisableNotesUsersAfterMigration=<#> - Provides an automated way to "encourage" users to start leveraging the target system after they are migrated.

[Notes] UserFolderPrefix=<FolderName> - By default, this is set to "Folders" to mirror the folder structure in the source Notes mail files. However, it can be customized to any value.

[General] MigrateRecurringBeforeRange=<#> and [General] SkipOutOfRangeExceptions=<#> - These allow you to tune the results when migrating recurring meetings with date filters applied.

[Exchange] MigrateResourceDelegation=<#> - This is new functionality for NME 4.7. It controls whether designated owners, authorized managers, and owner restrictions are converted during Notes Resource migration. Since this is new, it is currently turned off by default and must be enabled using this setting. If you feel this should be enabled by default in future releases, please let me know.

[Exchange] EncryptedItemCategory=<CategoryName> - Another cool new feature in NME 4.7 is the ability to stamp encrypted items with a category. When used in combination with a search folder, this provides an easy way for users to see all of the items that were encrypted in Notes from within their Outlook client.

Admittedly, the above list is rather lengthy, but hopefully it highlights some valuable options for your future migration projects.

I am planning future posts on GroupWise migration and the use of Self-Service Desktop Migrator. If there are other scenarios or settings that would be valuable to review, please let me know.

As always, happy migrating!

About the Author