To Configure an LDAP Data Source

The following procedure shows how to display the properties of an LDAP data source and how to set the properties that you require to change. The procedure shows the commands using which any of the properties of the LDAP data source can be changed. It also shows how to get the detailed information of a property, which helps you to set that property.

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

1. View the properties of the data source by using this command syntax:

   $ dpconf get-ldap-data-source-prop -h host -p port \ [-M unit] [-Z unit] source-name [property...]

   In this command, -M and -Z refer to the units in which you want data to be displayed. The M option specifies the unit of time. The value for -M can be M, w, d, h, m, s, or ms, to represent months, weeks, days, hours, minutes, seconds, or milliseconds. The -Z option specifies the data size unit. The value for -Z can be T, G, M, k, or b, to represent Terabytes, Gigabytes, Megabytes, kilobytes, or bytes.

   If you do not specify a property, all properties are displayed. The default properties of an LDAP data source are as follows:

   bind-dn : - bind-pwd : - client-cred-mode : use-client-identity connect-timeout : 10s description : - down-monitoring-interval : inherited is-enabled : false is-read-only : true ldap-address : host ldap-port : port ldaps-port : ldaps monitoring-bind-timeout : 5s monitoring-entry-dn : "" monitoring-entry-timeout : 5s monitoring-inactivity-timeout : 2m monitoring-interval : 30s monitoring-mode : reactive monitoring-retry-count : 3 monitoring-search-filter : (|(objectClass=*)(objectClass=ldapSubEntry)) num-bind-incr : 10 num-bind-init : 10 num-bind-limit : 1024 num-read-incr : 10 num-read-init : 10 num-read-limit : 1024 num-write-incr : 10 num-write-init : 10 num-write-limit : 1024 proxied-auth-check-timeout : 1.8s proxied-auth-use-v1 : false ssl-policy : never use-read-connections-for-writes : false use-tcp-keep-alive : true use-tcp-no-delay : true

2. Enable the data source.

   $ dpconf set-ldap-data-source-prop -h host -p port source-name is-enabled:true

3. Configure all the properties that are listed in Step 1, if you want to change the default settings.

   $ dpconf set-ldap-data-source-prop -h host -p port source-name property:value

   For example, if you want to modify entries on a data source, configure the data source to allow write operations.

   $ dpconf set-ldap-data-source-prop -h host -p port source-name is-read-only:false

   To use a read connection to process write operation when all the write connections are busy, run the following command. The vice-versa is also true.

   dpconf set-ldap-data-source-prop -h host -p port source-name \ use-read-connections-for-writes:true

   To find information about a property used in a subcommand, run this command:

   $ dpconf help-properties ldap-data-source property

   For example, to find information about the is-read-only property, run this command:

   dpconf help-properties ldap-data-source is-read-only

   To list the key properties for data sources, use the verbose option -v with the list-ldap-data-sources subcommand.

   $ dpconf list-ldap-data-sources -v Name is-enabled ldap-address ldap-port ldaps-port description ----------- ---------- ------------ --------- ---------- ----------- datasource0 true myHost myPort ldaps - datasource1 true myHost myPort ldaps -

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. For a list of configuration changes that require a server restart, see Configuration Changes Requiring Server Restart.