MAIL AND DIRECTORY MIGRATION

Updating existing Person documents
In some cases, for instance, in environments where the cc:Mail MTA passes mail between cc:Mail and Lotus Notes, users being migrated from cc:Mail may already have Person documents in the Domino Directory. The directory synchronization component of the MTA adds an unregistered Person document to the Domino Directory for each user in the cc:Mail directory.

When migrating users, it is recommended that you update existing Person documents, rather than create new ones. Creating multiple Person documents for a user can result in confusion and security problems. If you inadvertently create a second Person document for a user, delete one of the documents.

When you register a user, the registration process searches the Domino Directory to find a Person document that matches the one the cc:Mail Domino Upgrade Service created for the migrating user. Matches are based on entries in the User name field of the Person document. The registration process does not look for matching names in the short name field or the name component fields.

For a registered Lotus Notes user, the primary entry in the User name field is the Notes hierarchical name, which specifies the organization and organizational unit (OU) that a user belongs to. For an unregistered person, such as the directory listings created by the cc:Mail MTA, the Person document does not contain a hierarchical name.

When you migrate cc:Mail users, the cc:Mail Domino Upgrade Service automatically adds a hierarchical name to the Person document. The registration process generates this hierarchical name by parsing the cc:Mail name into Notes name components and appending OU information from the certifier ID used during registration. If you edit the Notes name components in the Register Person dialog box, Lotus Notes uses the modified name components to create the hierarchical name.

Adding the cc:Mail name to the Notes Person document

When migrating users from a cc:Mail MTA environment, the "Add cc:Mail name to Notes person document (required for cc:MTA)" option in the Migration Options list of the People and Groups Migration dialog box is selected by default. This option adds a user's cc:Mail name as a secondary entry in the user name field of the Notes Person document. As a result, Domino Upgrade Services can find an existing Person document created by the MTA that uses this name. If the cc:Mail name of the migrating user matches the user name in a single document in the Domino Directory, the cc:Mail Domino Upgrade Service prompts you to update that document.

If more than one matching document is found, the registration fails, and the user remains in the registration queue. Review the matching documents in the Domino Directory and modify names for the existing users or the new user to eliminate duplication. For example, you may need to add middle names to distinguish between users.

Suppressing prompts to update matching Person documents

By default, if the registration process finds a Person document in the Domino Directory that matches one generated for a migrating user, it prompts you to update or skip the registration. If you want to automatically update or skip the matching documents, follow this procedure to suppress these prompts.

1. When you are ready to register users, click Options on the Register Person dialog box.

2. In the Advanced Person Registration Options dialog box, select "Don't prompt for a duplicate person."

3. From the drop-down box, select "Update the existing address book entry."

See Also