Starting and Stopping Your Server Instance
Configuring the Server Instance
Configuring the Proxy Components
Modifying Network Group Properties
Creating a Network Group Quality of Service Policy
To Modify a Network Group Quality of Service Policy
Listing LDAP Server Extensions
Listing Proxy Workflow Elements
Viewing LDAP Proxy Element Properties
Viewing LDAP Server Extension Properties
Viewing Advanced LDAP Server Extension Properties
Viewing Proxy Workflow Element
Creating an LDAP Server Extension
Creating a Proxy LDAP Workflow Element
Modifying LDAP Server Extension Properties
Modifying LDAP Server Extension Advanced Properties
LDAP Data Source Monitoring Connection Properties
Modifying a Proxy LDAP Workflow Element Properties
Creating a Load Balancing Workflow Element
Creating a Load Balancing Algorithm
Creating the Load Balancing Routes
Modifying Load Balancing Properties
Modifying the Load Balancing Algorithm Type
Modifying the Load Balancing Route Properties
Setting Client Connection Affinity
Deleting Load Balancing Elements
Creating a Distribution Workflow Element
Creating a Distribution Algorithm
Creating a lexico or numeric Distribution Partition
Creating a dnpattern Distribution Partition
Configuring Global Index Catalogs
To Create a Global Index Catalog Containing Global Indexes
To View Global Index Catalog Properties
Modifying the Properties of a Global Index Catalog
To View Global Index Properties
To Import Contents of a File into a Global Index Catalog
To Export Contents of a Global Index Catalog to a File
To Associate a Global Index Catalog to a Distribution
To Disassociate a Global Index Catalog From a Distribution
To Add a Global Index to a Global Index Catalog
To Remove a Global Index From a Global Index Catalog
Configuring Controls Required by the Global Index Catalog with Sun OpenDS Standard Edition
Replication of Global Index Catalogs
To Enable Global Index Catalog Replication
To Initialize Global Index Catalog Replication
To Disable Global Index Catalog Replication
To View the Status of a Replicated Global Index Catalog Configuration
Logging of Replication Activities
Configuring Security Between Clients and Servers
Configuring Security Between the Proxy and the Data Source
Configuring Servers With the Control Panel
This section describes several typical lifecycle examples in which events take place in various replication topologies.
The first lifecycle example, illustrated by Figure 1, shows the creation of a replicated topology, with replicated global index catalog. In order to deploy this example, follow these steps.
An proxy data distribution deployment is configured on three instances of the Sun OpenDS Standard Edition proxy.
A global index catalog is configured separately on each instance of Sun OpenDS Standard Edition proxy, using the gicadm create-catalog command, followed by the gicadm add-index command for each of the values for cn and sn. The global index catalog is associated to the distribution using the gicadm associate command. These steps are described by the procedure To Create a Global Index Catalog Containing Global Indexes.
The content of a file is imported into the global index catalog on Sun OpenDS Standard Edition proxy instance 1 using the gicadm import --file command.
The gicadm enable-replication command is then issued on Sun OpenDS Standard Edition proxy instance 1, to enable replication between instances 1 and 2.
The gicadm enable-replication command is then issued on Sun OpenDS Standard Edition proxy instance 1, to enable replication between instances 1 and 3.
The gicadm initialize-replication --all command is then issued on Sun OpenDS Standard Edition proxy instance 1.
In the second lifecycle example, illustrated by Figure 2, three instances of Sun OpenDS Standard Edition proxy are running with a replicated global index catalog, as configured in lifecycle example 1. If proxy instance 3 goes down or is stopped, for whatever reason, you'll need to follow these steps in order to ensure that the three instances of the proxy are replicated.
Issue the start-ds command on proxy instance 3.
Note - Once the proxy instance is restarted, the global indexes are empty.
If the global index catalog property auto-sync-at-startup is set to true (default), proxy instance 3 will automatically retrieve the global index data from the other instances of Sun OpenDS Standard Edition proxy and all three global index catalogs in the topology will be correctly replicated.
If the global index catalog property auto-sync-at-startup is set to false, then you will have to manually synchronize the global index data by running gicadm initialize-replication
You can check to see if replication is complete by executing the gicadm status-replication command, as described in To View the Status of a Replicated Global Index Catalog Configuration.
In the third lifecycle example, illustrated by Figure 3, three instances of Sun OpenDS Standard Edition proxy are running with a replicated global index catalog, as configured in lifecycle example 1. If you want to add an additional attribute, for example, mail, to the replicated global index catalog, follow these steps.
First, execute gicadm add-index mail command on each of the three instances of the Sun OpenDS Standard Edition proxy.
Export the directory data under the distribution route from one of the remote LDAP servers to an LDIF file named file1 using export-ldif.
Run split-ldif on the exported file (file1) to generate a file (file1–gi-mail) that contains the data for the attribute for which you are creating a new global index.
Then on Sun OpenDS Standard Edition proxy instance 1, execute the gicadm import --file file1-gi-mail command. The mail index will be updated simultaneously on all global indexes.
Repeat steps 2–4 for each of the remote LDAP servers.
In the fourth lifecycle example, illustrated by Figure 4, three instances of Sun OpenDS Standard Edition proxy are running with a replicated global index catalog, as configured in lifecycle example 1. If you want to overwrite the content of the global index catalogs on proxy instances 2 and 3 with the content of the global index catalog on instance 1, follow these steps.
On proxy instance 1, execute the gicadm initialize-replication --all command. This replaces the content of the global index catalog on proxy instance 2 and 3 with the content of the global index catalog on proxy instance 1.
In the fifth lifecycle example, illustrated by Figure 5, three instances of Sun OpenDS Standard Edition proxy are running with a replicated global index catalog, as configured in lifecycle example 1. To add a fourth instance of Sun OpenDS Standard Edition proxy with a replicated global index catalog, follow these steps.
On Sun OpenDS Standard Edition proxy instance 4, execute the gicadm create-catalog command.
On Sun OpenDS Standard Edition proxy instance 4, run the commandsgicadm add-index cn, gicadm add-index sn, and gicadm add-index mail.
On Sun OpenDS Standard Edition proxy instance 4, execute the gicadm associate command.
Finally, on Sun OpenDS Standard Edition proxy instance 4, run the following command:
gicadm enable-replication --localReplicationPort replication port of instance 4 --remoteHost name or IP address of host running instance 1
This command configures the replication between instance 1 and instance 4. The replication of the global index catalogs will be done automatically, assuming that the global index catalog property auto-sync-at-startup has been left to the default value of true.
If the global index catalog property auto-sync-at-startup is set to false, then you will have to manually synchronize the global index data by running gicadm initialize-replication