PingDirectory

Configuring the Globally Unique Attribute plugin

About this task

The following example shows how to configure the Globally Unique Attribute plugin. The example defines an attribute set consisting of the telephoneNumber and mobile attributes within the test-view subtree view.

The multiple-attribute-behavior property determines the scope of how attributes might differ among entries and is the same property for the directory server plugin. The property is set to unique-across-all-attributes-including-in-same-entry, which indicates that the telephone and mobile attributes must be unique throughout the subtree view, even within an entry.

The pre-commit-validation property ensures that the Globally Unique Attribute Plugin performs one or more searches to determine whether any entries conflict with the change, such as add, modify, or modifyDN. If a conflict is detected, the change request is rejected.

You should index all configured attributes for equality in all backend servers.

Steps

  • To create the Globally Unique Attribute plugin, run dsconfig with the create-plugin option.

    Example:

    $ bin/dsconfig create-plugin \
      --plugin-name "Globally-Unique telephone and mobile" \
      --type globally-unique-attribute \
      --set enabled:true \
      --set type:telephoneNumber \
      --set type:mobile \
      --set subtree-view:test-view \
      --set multiple-attribute-behavior:unique-across-all-attributes-including-in-same-entry \
      --set pre-commit-validation:all-available-backend-servers