To Configure Distribution with Load Balancing

Create the proxy LDAP server extensions:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-extension \
--extension-name proxy_extension1 \
--type ldap-server \
--set enabled:true \
--set remote-ldap-server-address:DS1_hostname \
--set remote-ldap-server-port:2389
```
The LDAP server extension is a link to the back-end LDAP server. For this use case, you will need four back-end LDAP server instances. Go through this step once for each back-end LDAP server, making sure to use a different LDAP hostname and port.
Create a proxy workflow element for each LDAP server extension:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-workflow-element \
--element-name proxy-we1 \
--type proxy-ldap\ 
--set enabled:true \
--set client-cred-mode:use-client-identity \
--set ldap-server-extension:proxy_extension1
```
For this use case, you will need four back-end LDAP server instances. Go through this step once for each back-end. The LDAP server extension name should be the same as those created in step 1.
The property client-cred-mode indicates the type of authentication used between the proxy and back-end LDAP server. The client credential mode can be: use-client-identity, use-specific-identity, or use-proxy-auth.
Create a load balancing workflow element:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-workflow-element \
--element-name LB-we1 \
--type load-balancing \
--set enabled:true
```
You only need one load balancing workflow element to route requests to either of the two back-end LDAP servers. In this use case, since you are using two load balancers, you will need to create two load balancing workflow elements.
Define the load balancing algorithm:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-load-balancing-algorithm \
--element-name LB-we1 \
--type failover
```
The type of load balancing algorithm can be proportional, saturation or failover. The properties of the load balancing algorithm (weight, threshold, or priority) are defined with the load balancing routes, in the next step. For this use case, you will need two load balancing algorithms.
Define the load balancing routes for each proxy:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-load-balancing-route \
--element-name LB-we1 \
--route-name LB-route1 \
--type failover \
--set workflow-element:proxy-we1 \
--set priority:1
```
For this use case, you will need four load balancing routes. Set two routes per load balancing workflow element (created in the previous step); for example, one route with priority 1 and the other route with priority 2.

Note - The properties in the example above set the priority for failover load balancing. If you use proportional or saturation load balancing, the properties will differ. For more information on the setting different load balancing types, see Modifying the Load Balancing Route Properties in Sun OpenDS Standard Edition 2.2 Administration Guide.

Set up distribution by creating a distribution workflow element:

$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-workflow-element \
--element-name distrib-we \
--type distribution \ 
--set base-dn:dc=example,dc=com \
--set enabled:true

For this use case, you will need only one distribution workflow element, which will point to the distribution algorithm.

Set the distribution algorithm:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-distribution-algorithm \
--element-name distrib-we \
--type numeric \ 
--set distribution-attribute:uid
```
The type of distribution algorithm can be numeric, lexicographic, or by DN pattern match. The boundaries are defined when you create the distribution partitions, in the next step.
Define the distribution partitions:
```
$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-distribution-partition \
--element-name distrib-we \
--partition-name distrib-part1\
--type numeric \ 
--set lower-bound:0 \
--set upper-bound:1000 \
--set partition-id:1 \
--set workflow-element:LB-we1
```
For this use case, you will need to create two partitions. Make sure that the partition ID and the partition name are unique for each workflow element, and that each partition uses a different load balancing workflow element. You must specify the same type when defining the routes as you did when defining the load balancing algorithm.

Note - The upper boundary indicated is exclusive. This means that if you indicate 1000 as the upper boundary, the partition will only include values from 0 to 999, inclusive.

Create a workflow:

This workflow associates the distribution workflow element with the base DN.

$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-workflow \
--workflow-name workflow \
--set enabled:true \
--set base-dn:dc=example,dc=com \
--set workflow-element:distrib-we

Create the network group:

The network group handles all the requests between the client and the proxy.

$ dsconfig -p 4444 -h localhost -D"cn=Directory Manager" -w password \
create-network-group \
--group-name network-group1 \
--set enabled:true \
--set workflow:workflow \
--set priority:1

Exit Print View
Sun OpenDS Standard Edition 2.2 Deployment Planning Guide