Migrator for Notes to Exchange 4.16.1 - Pre-Migration Planning Guide

How remigrations affect folder ACLs and delegate (Send on Behalf of) rights

Remigrations are handled differently depending on what component is used to write migrated data to Exchange. MNE uses a component for writing migrated data to Exchange with the MAPI over HTTP protocol. This new component replaces the MAPI library provided by Microsoft Outlook. All migrations use this new components by default unless it is explicitly disabled (through the [Exchange] UseMneMapiHttpLib parameter), or if the new component minimum requirements are not met.

When migrating using the MNE MAPI/HTTP library, remigrations can be influenced using the [Exchange] RemigrateMode parameter as described in the following topic.

Permissions for individual users are added to the folder permission table in Exchange if a permission for the user on that folder does not currently exist. Permissions are never removed from or overwritten on the Exchange folder.

Users who have the Send on Behalf of permission in Notes but who do not currently have the permission in Exchange are granted the access in Exchange. Users who have the Send on Behalf of permission in Exchange but who do not have the permission in Notes do not have their Send on Behalf of rights revoked. Users with the rights in both are not affected.

In summary, permissions in Notes are merged with the permissions configured on the folder in Exchange, with any conflicts handled by giving preference to the permissions configured on the Exchange folder.

Permissions for individual users are added to the folder permission table in Exchange if a permission for the user on that folder does not currently exist. Permissions are never removed from the Exchange folder. However, if the user does have permissions already configured on the folder in Exchange, it is overwritten.

Users who have the Send on Behalf of permission in Notes who do not currently have the permission in Exchange are granted the access in Exchange. Users who have the Send on Behalf of permission in Exchange who are not explicitly listed in Notes do not have their Send on Behalf of rights revoked. However users that are explicitly denied Send on Behalf of permission in Notes have their rights revoked in Exchange. Users with the rights in both are not affected.

In summary, permissions in Notes are merged with the permissions configured on the folder in Exchange, with any conflicts handled by giving preference to the permissions configured on the Notes mail file.

If MNE does not migrate data using the new MNE MAPI over HTTP library, it migrates data to Exchange using the legacy Outlook MAPI library. When migrating with the Outlook MAPI library, permissions on the Exchange mailbox folder as well as the list of users who have the Send on Behalf of right are always entirely replaced. Any permissions that may have been migrated by previous migrations or added by users before the remigration takes place are overwritten.

Migrating calendar ACLs and delegation rights

Migrator for Notes to Exchange's Data Migration Wizard offers an assortment of options for mapping some Notes access levels to Exchange, for calendar and to-do items. Specifically, the No Access and the Depositor access levels are mapped as shown in the following table, for selected Read Public and Write Public Notes permissions. Mapping depends on values set for NME Parameters [Notes] MapDefaultAclToReviewer and [Notes] ElevateCalendarAuthorACLtoEditor.

The Data Migration Wizard can also migrate Notes' "send on behalf of" delegation rights. Delegation rights are useful when one user wants to let another user have access to his or her Outlook Calendar, to generate meeting invitations and accept/decline invitations from others, as is common in a boss-secretary relationship. Notes delegation rights correspond to the publicDelegates property in Active Directory. Migration of delegation rights is enabled by default, but can be disabled by setting PublicDelegates=0 in the [General] section of the Global Defaults or Task Parameters.

Migrating DocLinks

Notes DocLinks can be migrated in any of four forms:

NOTE: This Domino webserver option is incompatible with an Offline migration, since Migrator for Notes to Exchange cannot connect to an offline Domino server to perform the DocLink translation.

Your Migration Plan should specify the destination format for migrated Notes DocLinks. The choice of destination format is controlled by a selection on the Specify How To Migrate Notes DocLinks screen, within the Data Migration Wizard. By default, DocLinks are migrated to Exchange as NOTES links.

Migrating Notes "Active Mail"

Migrator for Notes to Exchange can detect and convert Notes rich-content features whereby messages carry "live" or "active" functional content for things such as:

These features, called Active Mail, are normally lost or degraded when migrated to Exchange due to the differences between the mail platforms. However, Migrator for Notes to Exchange—both the Data Migration Wizard and the SSDM—can detect and process Active Mail content to preserve its functionality.

Migrator for Notes to Exchange encapsulates Active Mail functionality within an NSF file attachment. Assuming a Notes client is still installed on the migrated user Outlook computer, and the NSF file type is associated (in Windows) with the Notes client application, the Outlook user can double-click the icon to open the attached NSF file in Notes with the fully functional Active Mail content in view.

Active Mail processing is an optional feature that is disabled by default, but can be enabled by a check box on the Specify Data to Migrate screen in the Data Migration Wizard:

In the SSDM, you can enable the feature by setting program parameters in the notesdtapp.ini file. These settings are described in chapter 4 of the Migrator for Notes to Exchange Scenarios Guide — see the topic How to customize the SSDM.

In the Specify Data to Migrate screen, click Configure (next to the check box) to specify your preferences for the Active Mail features. (The dialog box options are described in the Migrator for Notes to Exchange Administration Guide, chapter 10, for the Specify Data to Migrate screen and in the online help).

Part of the configuration requires that you specify a filename and location for a Notification message—a file that contains a text string that MNE inserts at the top of the body of any migrated message containing Active Mail. MNE installs a default file named ActiveMailNotificationMessage.txt to the installation directory, but you can specify a different filename and/or folder.

The Notification message text file must be UTF-8 encoded and must contain a placeholder, called $ActiveMailAttachment$, that MNE replaces with the Active Mail NSF attachment when the message is migrated. Since the contents of this file become part of an RTF body, characters such as "\", "{", and "}" must be escaped with a leading "\" (so they become, respectively, "\\", "\{", and "\}").