Move/Rename

Move and Rename events are not supported in the default configuration. However, you can synchronize a Move or Rename event in Notes across the Publisher channel and into eDirectory if you modify the default Schema Map and the default Publisher Filter, and add a policy.

In addition, you can synchronize a Move or Rename event on the Subscriber channel if you have Notes 6.0.3 or later, enable AdminP support, and add policies that provide the necessary attributes.

In this section:

• Subscriber Channel
• Publisher Channel
• Considerations for Using AdminP

Subscriber Channel

In this section:

• Moving a User
• Modifying a User Name in eDirectory (a Rename Event in Notes)
• Renaming a Group

Moving a User

1. Make sure you are using Notes 6.0.3 or later and have reviewed Considerations for Using AdminP.

2. Make sure you have turned on support for the AdminP process, by adding the following parameter to the Subscriber Options in the driver parameters:

   <allow-adminp-support display-name="Allow Domino AdminP Support">True</allow-adminp-support>

   See Allow Domino AdminP Support in Subscriber Options.

3. Create driver policies that add the following attributes to the move event:

   • The certifier name of the destination certifier in Notes.
   • The certifier ID and a password for the destination certifier in Notes (the certifier that the user is going to)
   • The old certifier ID and password for the source certifier in Notes (the certifier that the user is coming from)

   A sample of a command to the driver shim that moves a user is included in Sample of Moving a User.

Modifying a User Name in eDirectory (a Rename Event in Notes)

When a user's given name, middle initial, or surname changes in eDirectory, this event can cause the Rename of an object in Lotus Notes. If you have Notes 6.0.3 or later with AdminP support enabled, you can perform the Rename in Notes.

1. Make sure you are using Notes 6.0.3 or later and have reviewed Considerations for Using AdminP.

2. Make sure you have turned on support for the AdminP process, by adding the following parameter to the Subscriber Options in the driver parameters:

   <allow-adminp-support display-name="Allow Domino AdminP Support">True</allow-adminp-support>

   See Allow Domino AdminP Support in Subscriber Options.

3. Create driver policies that provide the correct certifier and password for the Notes user that is being renamed.

   If a certifier and password are not specified in the event, the default certifier and password specified in the driver parameters are used.

   A sample of a command to the driver shim that renames a user is included in Sample of Renaming: Modifying a User Last Name.

Renaming a Group

If you have Notes 6.0.3 or later with AdminP support enabled, you can rename groups. Rename events from eDirectory for groups do not require you to create any additional driver policies.

Rename events from eDirectory can be applied only to group objects in Notes. (For users, the driver shim uses an appropriate modify event to rename a user in Notes, as described in Modifying a User Name in eDirectory (a Rename Event in Notes).)

1. Make sure you are using Notes 6.0.3 or later and have reviewed Considerations for Using AdminP.

2. Make sure you have turned on support for the AdminP process, by adding the following parameter to the Subscriber Options in the driver parameters:

   <allow-adminp-support display-name="Allow Domino AdminP Support">True</allow-adminp-support>

   See Allow Domino AdminP Support in Subscriber Options.

Publisher Channel

To enable the one-way object move/rename synchronization:

1. Modify the schema mapping to map eDirectory Full Name to Notes FullName.

2. Enable the Full Name attribute in the Publisher filter.

3. Make sure that the Full Name attribute in the Subscriber filter is not enabled.

4. Make sure that the Public/Private AB setting is Yes in the driver configuration parameters.

5. Use a policy in your driver configuration like the one described in Determining eDirectory Object Placement When a Notes Object is Moved.

After these modifications have been made, ndsrep detects changes to FullName. Because FullName contains both name and location information in a single attribute, ndsrep cannot distinguish between a Move and a Rename. Therefore, a change to FullName initiates both a Move and a Rename event to be synchronized into eDirectory.

Considerations for Using AdminP

AdminP support provides several new features, but to use them effectively you must keep in mind the following:

• You need to have an understanding of AdminP and of Notes administration.
• A success message returned to the driver for an AdminP request means only that the request was successfully received by AdminP, not that it was completed successfully.
• AdminP requests made by the driver are not completed until AdminP attempts the action. The timing depends on the configuration of the Administration Process by the Notes administrator, the Domino server network, and the complexity of the action requested.
• Some AdminP requests require manual approval by the Notes administrator before they are completed.
• AdminP requests typically include the FullName of the Notes user (or ListName for a group). The driver sends requests based on the FullName of the user at the time the request was initiated, but AdminP does not necessarily complete the request right away, and other requests that affect the FullName of the same user object might be waiting to be processed. If the FullName of the user is changed by a request, a subsequent request might fail because AdminP can't find the user.

  For example, consider this scenario:

  • You send a request from the driver to change a user's first name in Notes, and you use the AdminP feature to also rename the user object (changing FullName).
  • You immediately send a second request from the driver to change the same user's last name in Notes and also rename the user object (changing FullName).

  Both requests are received by AdminP. Both requests refer to the user with the same FullName. At midnight, AdminP begins processing the requests. The first one succeeds. However, the second one fails because the FullName was changed by the first request.

To help you use AdminP effectively, the following features are provided:

• You can cause the driver to send commands directly to the Domino Console. For example, you can issue a command to process all AdminP requests immediately. See Tell AdminP Commands, and Domino Console Command in Overriding Driver Parameters.
• You can enable or disable AdminP support for an individual command. See Allow AdminP Support in Overriding Driver Parameters.