Creating and Configuring Coordinator Data Views

The Coordinator data view has an ordered list of data views to coordinate. When the Coordinator data view receives a request, it sends the request to its coordinated data views in the right order, which is defined by the order used in the CLI to specify the coordinated data view. The Coordinator data view sends the request to coordinated data view as defined by the routing policy and in the end returns the result(s) to the client. For more information, see Coordinator Data Views in Sun Directory Server Enterprise Edition 7.0 Reference.

The Coordinator data view supports the following routing policies:

• first-match: stops sending the request at first match

• all-candidates: sends the request to all the coordinated data views

• mirror: sends all the requests to first coordinated data view but the write requests are sent to all the coordinated data views.

All the data views coordinated by a coordinator data view must have the same view base identical with the view base of the coordinator data view.

To Create a Coordinator Data View

You cannot use DSCC to perform this task. Use the command line, as described in this procedure.

1. Identify the data views that will be aggregated to form the Coordinator data view.

   The data views must exist before the Coordinator data view can be created. The data views can be any type of data view, including an LDAP data view, LDIF data view, JDBC data view, or another join data view.

2. Create the Coordinator data view.

   $ dpconf create-coordinator-data-view -h host -p port VIEW_NAME \ COORDINATED_VIEW [COORDINATED_VIEW...] SUFFIX_DN

   The following command creates a Coordinator data view, view_com, using two data views.

   $ dpconf create-coordinator-data-view -h host -p port view_com \ first_view second_view dc=com

3. (Optional) View the list of Coordinator data views to check that your data view has been created successfully.

   $ dpconf list-coordinator-data-views -h host -p port

   In this case, the above command displays view_com.

To Configure a Coordinator Data View

You cannot use DSCC to perform this task. Use the command line, as described in this procedure.

1. View the properties of a Coordinator data view.

   $ dpconf get-coordinator-data-view-prop -h host -p port VIEW_NAME

   The default properties of a join data view are as follows:

   alternate-search-base-dn : "" attr-name-mappings : none base-dn : "" contains-shared-entries : - coordinated-data-view : first_view coordinated-data-view : second_view custom-distribution-algorithm : none description : - distribution-algorithm : none dn-join-rule : none dn-mapping-attrs : none dn-mapping-source-base-dn : none excluded-subtrees : "" filter-join-rule : none is-enabled : true is-read-only : false is-routable : true lexicographic-attrs : all lexicographic-lower-bound : none lexicographic-upper-bound : none non-viewable-attr : none non-writable-attr : none numeric-attrs : all numeric-default-data-view : false numeric-lower-bound : none numeric-upper-bound : none pattern-matching-base-object-search-filter : all pattern-matching-dn-regular-expression : all pattern-matching-one-level-search-filter : all pattern-matching-subtree-search-filter : all process-bind : - replication-role : master routing-policy : all-candidates viewable-attr : all except non-viewable-attr writable-attr : all except non-writable-attr

   For example, the following commands lists the coordinated-data-views property of the specified Coordinator data view.

   $ dpconf get-coordinator-data-view-prop VIEW_NAME coordinated-data-view coordinated-data-view : first_view coordinated-data-view : second_view

2. Change one or more of the properties that are listed in Step 1.

   $ dpconf set-coordinator-data-view-prop -h host -p port VIEW_NAME PROP:VAL \ [PROP:VAL...]

   For example, add more coordinated data views to the Coordinator data view using the following command:

   $ dpconf set-coordinator-data-view-prop -h host -p port view_com \ coordinated-data-view+:third_view coordinated-data-view+:fouth_view

   As per the order of the coordinated data views specified in the above command, the coordinated data views are send in the following order:

   $ dpconf get-coordinator-data-view-prop VIEW_NAME coordinated-data-view coordinated-data-view : first_view coordinated-data-view : second_view coordinated-data-view : third_view coordinated-data-view : fourth_view

3. (Optional) Change the routing-policy mode that describe how Coordinator data view sends the requests to coordinated data views.

   $ dpconf set-coordinator-data-view-prop -h host -p port view_com \ routing-policy:first-match

   For more information, see routing-policy(5dpconf).

4. If necessary, restart the instance of Directory Proxy Server for the changes to take effect.

   For information about restarting Directory Proxy Server, see To Restart Directory Proxy Server.