Chat now with support
Chat with Support

Migrator for Notes to Exchange 4.16.1 - Administration Guide

About the Migrator for Notes to Exchange documentation Notes Migration Manager NABS Discovery Wizard Internet Domains Discovery Wizard Directory Export Wizard Collection Wizard Groups Provisioning Wizard Notes Data Locator Wizard Provisioning Wizard Send PAB Replicator Wizard Data Migration Wizard SSDM Statistics Collection Wizard The Log Viewer Using the Qsched.exe task-scheduling utility SSDM Scheduling Administration utility Office 365 Admin Account Pool utility PowerShell cmdlets for Migrator for Notes to Exchange Appendix A: How do I ...?
Post-installation configuration Pre-migration preparations Batch-migration process Other features

Introduction

The most common method for provisioning Active Directory begins with a directory update using the Quest Coexistence Manager for Notes (CMN) Directory Connector. The CMN tool can extract data from the Notes/Domino source and create mail-enabled security objects or contacts in Active Directory for all Notes users. If the migrating users are already using AD security objects for network authentication, the directory update should have been configured to create new AD contacts which now correspond to the existing user objects in AD. In this case, The Provisioning Wizard can consolidate such duplicates before any data is migrated.

The Provisioning Wizard is run only once per user collection and must be run before the Data Migration Wizard is run for those users. The user collection is specified in the Notes Migration Manager screen (see User Collections: Provision Users).

Field definitions and application notes for the wizard screens appear in the sections that follow (under Wizard process screens).

How the wizard works

User object records in Active Directory contain several data elements—last names, first names, titles, SMTP email addresses, and so on—and the values for at least one of these attributes must be unique per object record. For example, no two users can have the same DN. (For the Provisioning Wizard we assume that no two users can have the same SMTP email address.)

Contacts in AD are characterized by a similar set of field values, at least one of which must be unique per contact. When a Domino-to-AD directory update creates new AD contacts (representing Notes users), some or all the contact records can correspond to existing user objects in AD. The Provisioning Wizard can associate contacts with user objects by finding the unique values of the pertinent AD object attribute that match unique values of the corresponding field in the contacts. The wizard prompts you for an attribute that corresponds to which field for these comparisons.

The Provisioning Wizard is applied to a particular user collection that you specify when you launch the wizard from Notes Migration Manager (see User Collections: Provision Users). The “match” attribute that the wizard uses to compare and match AD contacts and users must correspond to an attribute in the MNE SQL database from which the collections are drawn. For each user in the designated collection, the wizard reads the match attribute value, and looks in AD for the single contact and the single user whose corresponding attribute values both match the value from the user record in the SQL database. When it finds a match, it merges the contact information into the user object record, and deletes the contact, leaving a single mailbox- enabled object per user in Active Directory.

Before you run the Provisioning Wizard

Before running the Provisioning Wizard, you must:

•
Verify that the SQL database contains a column whose per- contact values are unique and that match the values for a corresponding AD object attribute. If the database does not contain a populated column for this purpose, you must enter appropriate values into the SearchKey column as described following. The Provisioning Wizard provides the following options in a drop-down list:
•
DisplayName: Copied by Directory Export Wizard from the first value of the Notes FullName attribute that is not a DN ("CN=Joe Schmoe/O=Acme") or SMTP address (Joe.Schmoe@acme.com) or, if every FullName is a DN or SMTP address, the “CN” portion of the first FullName that is a DN ("CN=xxx/...").
•
GivenName: Copied by Directory Export Wizard from the Notes FirstName.
•
Userid: Copied by Directory Export Wizard from the first value of the Notes ShortName that is not an SMTP address (same as Nickname column below).
•
Surname: Copied by Directory Export Wizard from the Notes LastName attribute.
•
PhoneticName: Copied by Directory Export Wizard from the Notes AltFullNameSort attribute.
•
Nickname: Copied by Directory Export Wizard from the first value of the Notes ShortName that is not an SMTP address (same as Userid column).
•
EmployeeID: Copied by Directory Export Wizard from the Notes EmployeeID.
•
SourceAddress: Derived by Directory Export Wizard from the first value of the Notes FullName attribute that is a DN ("CN=Joe Schmoe/O=OurCompany"), with “CN=” and “O=” stripped out (leaving “Joe Schmoe/OurCompany”).
•
TargetAddress: Copied by the Directory Export Wizard from the Notes internetAddress. If there is no internetAddress attribute defined in the Notes person document, the wizard generates a TargetAddress from ShortName@ the default domain (designated on the Find Domains screen).
•
SearchKey: Column not populated by Directory Export Wizard. May be manually populated with user-identifying values (unique per user) that the Provisioning Wizard can use to match objects for merging if none of the other column options is suitable for the merge process. The procedure to edit these values is explained in the following section.
•
SearchKey2: Column is not populated by Directory Export Wizard. Can be manually populated with user-identifying values (unique per user) that the Data Migration Wizard can use to properly associate resource accounts with corresponding user accounts, and properly enable mailboxes (used only when Active Directory is configured for a resource forest and a user forest, with corresponding user accounts). This process is explained in Appendix A, under How Do I Prepare the SQL database for Mailbox-Enabling (If AD Is Configured for a Resource Forest and a User Forest)?
•
SourceForwardingAddress: Column is not populated by Directory Export Wizard. Can be manually populated to contain addresses used by the Data Migration Wizard to forward mail from Notes to Exchange. If this column is empty and the Data Migration Wizard set for Notes-to-Exchange forwarding, the wizard will infer suitable values from the values in other database columns.
•
TargetForwardingAddress: Column is not populated by Directory Export Wizard. Can be manually populated to contain addresses used by the Data Migration Wizard to forward mail from Exchange to Notes. If this column is empty and the Data Migration Wizard set for Exchange-to-Notes forwarding, the wizard will infer suitable values from the values in other database columns.
To edit the SearchKey column of the data table
1
In the Manage Users (User Collections) screen of Notes Migration Manager, select the collection whose contacts you want to merge.
2
Click Export objects to TSV to export the data to a .tsv (tab-separated values format) file.
3
Enter the destination folder and file name in the dialog box.
4
Use Microsoft Excel (or some program that can edit a tsv-format file) to edit the contents of the table.
You can add, edit, and delete the contents of any existing cell in the table, but any addition or deletion of an entire row or column is ignored when you import the data back into the database.
5
Find a column in the exported data table that is suitable for the merge process—containing values that are unique per user, and that correspond to the values of the pertinent AD object attribute.
6
Copy the values of that column into the SearchKey column. If no column exactly corresponds to the pertinent AD attribute, you can find a column with values that can be massaged to match by appending or stripping some segment of the data string, or merging the values with the data in another column or from some other source.
7
In Notes Migration Manage, click Import objects from TSV to import the edited .tsv file into the SQL database. A dialog box will prompt you for the filename and its location.
8
Verify that the drop-down list in the Choose Your Method... screen offers the AD attribute you want for the merge function. By default, the drop-down list contains these options:
 

 

cn

mail

mailNickname

proxyAddresses

sAMAcountName

userPrincipalName

targetAddress

employeeNumber

distinguishedName

altRecipient

legacyExchangeDN

extensionAttribute1

extensionAttribute2

extensionAttribute3

extensionAttribute4

extensionAttribute5

extensionAttribute6

extensionAttribute7

extensionAttribute8

extensionAttribute9

extensionAttribute10

extensionAttribute11

extensionAttribute12

extensionAttribute13

extensionAttribute14

extensionAttribute15

 

If the attribute you want does not appear in this list, you must add it as described in Appendix A: see How Do I Add to the List of AD Attributes Available for the Merge Function?

Wizard process screens

The Provisioning Wizard is configured on these screens:

•
Select Configuration
•
Select User Collection
•
Customize Configuration
•
Specify Active Directory Information
•
Choose Your Method for Finding Objects
•
Choose the Container for User Objects
•
Generating Task
•
Configuration Summary
•
Creating Task
•
Specify Task Schedule
•
Task Progress
•
Task Completed
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating