Configuring Connections Between Directory Proxy Server and Back-End LDAP Servers

When an LDAP data source is created, the number of default connections opened for the LDAP data source are six, that is, two for each read, bind, and write operations respectively. To verify the default connections, type the following command:

dpconf get-ldap-data-source-prop src-name num-read-init num-write-init num-bind-init
num-bind-init   :  2
num-read-init   :  2
num-write-init  :  2

The number of connections increases automatically when the traffic increases.

For information about how to configure connections between Directory Proxy Server and back-end LDAP servers, see the following procedures:

To Configure the Number of Connections Between Directory Proxy Server and Back-End LDAP Servers

This procedure configures the number of connections for bind operations. To configure the number of connections for read or write operations, perform the same procedure but replace bind with read or write.

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

1. Configure the initial number of connections between Directory Proxy Server and a back-end LDAP server for bind operations.

   $ dpconf set-ldap-data-source-prop -h host -p port data-source-name \ num-bind-init:new-value

2. Configure the increment of connections for bind operations.

   The increment is the number of connections that are added each time more than the current number of connections are requested.

   $ dpconf set-ldap-data-source-prop -h host -p port data-source-name \ num-bind-incr:new-value

3. Configure the maximum number of connections for bind operations.

   When this maximum number of connections is reached, no more connections can be added.

   $ dpconf set-ldap-data-source-prop -h host -p port data-source-name \ num-bind-limit:new-value

To Configure Connection Timeout

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

1. Configure the maximum length of time that Directory Proxy Server can attempt to connect to a data source.

   $ dpconf set-ldap-data-source-prop -h host -p port data-source-name \ connect-timeout:new-value

   For example, configure the connection timeout to 10 milliseconds.

   $ dpconf set-ldap-data-source-prop -h host1 -p 1389 data-source-name connect-timeout:10

To Configure Connection Pool Wait Timeout

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

1. Configure the maximum length of time that Directory Proxy Server can wait for an established connection in a connection pool to become available.

   $ dpconf set-server-prop -h host -p port data-source-name \ connection-pool-wait-timeout:value

   For example, configure the timeout to 20 seconds.

   $ dpconf set-ldap-data-source-prop -h host1 -p 1389 data-source-name \ connection-pool-wait-timeout:20000