Exit Print View

Sun OpenDS Standard Edition 2.2 Administration Guide

Get PDF Book Print View
 

Document Information

Before You Start

Starting and Stopping Your Server Instance

Configuring the Server Instance

Configuring the Proxy Components

Configuring Network Groups

Creating a Network Group

To Create a Network Group

Modifying Network Group Properties

Creating a Network Group Quality of Service Policy

To Modify a Network Group Quality of Service Policy

Configuring a Workflow

Listing Existing Workflows

Viewing Workflow Properties

Creating a Workflow

Configuring Workflow Elements

Listing Workflow Elements

Configuring an LDAP Proxy

Listing LDAP Proxy Elements

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

Adding an LDAP Proxy

Creating an LDAP Server Extension

Creating a Proxy LDAP Workflow Element

Modifying an LDAP Proxy

Modifying LDAP Server Extension Properties

Modifying LDAP Server Extension Advanced Properties

LDAP Data Source Monitoring Connection Properties

Modifying a Proxy LDAP Workflow Element Properties

Configuring Load Balancing

Configuring Load Balancing

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

Configuring Distribution

Configuring Distribution

Creating a Distribution Workflow Element

Creating a Distribution Algorithm

Creating a lexico or numeric Distribution Partition

Creating a dnpattern Distribution Partition

Managing Modify DN Requests

Deleting Distribution

Configuring the Global Index

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

Lifecycle Examples for Replicated Global Index Catalogs

Configuring Security Between Clients and Servers

Configuring Security Between the Proxy and the Data Source

Configuring Servers With the Control Panel

Managing Directory Data

Replicating Directory Data

Controlling Access To Data

Managing Users and Groups

Monitoring Sun OpenDS Standard Edition

Improving Performance

Advanced Administration

Lifecycle Examples for Replicated Global Index Catalogs

This section describes several typical lifecycle examples in which events take place in various replication topologies.

Creating a Replicated Topology and Enabling Global Index Catalog Replication

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.

  1. An proxy data distribution deployment is configured on three instances of the Sun OpenDS Standard Edition proxy.

  2. 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.

  3. 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.

  4. The gicadm enable-replication command is then issued on Sun OpenDS Standard Edition proxy instance 1, to enable replication between instances 1 and 2.

  5. The gicadm enable-replication command is then issued on Sun OpenDS Standard Edition proxy instance 1, to enable replication between instances 1 and 3.

  6. The gicadm initialize-replication --all command is then issued on Sun OpenDS Standard Edition proxy instance 1.

Figure 1
Replicated Global Index Catalog Topology
Three proxy servers with replicated global index catalogs
A Global Index Catalog in a Replicated Topology is Restarted

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.

  1. Issue the start-ds command on proxy instance 3.


    Note - Once the proxy instance is restarted, the global indexes are empty.


  2. 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

  3. 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.

Figure 2
A Global Index Catalog in a Replicated Topology is Restarted
A Global Index Catalog in a Replicated Topology is Restarted
Adding a Global Index to a Replicated Global Index Catalog Topology

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.

  1. First, execute gicadm add-index mail command on each of the three instances of the Sun OpenDS Standard Edition proxy.

  2. Export the directory data under the distribution route from one of the remote LDAP servers to an LDIF file named file1 using export-ldif.

  3. 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.

  4. 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.

  5. Repeat steps 2–4 for each of the remote LDAP servers.

Figure 3
Adding a Global Index to a Replicated Global Index Catalog Topology
A global index with mail attributes is added to the existing global index catalogs.
Overwriting the Contents of Replicated Global Index Catalogs

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.

  1. 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.

Figure 4
Overwriting the Contents of Replicated Global Index Catalogs
Overwriting the Contents of Replicated Global Index Catalogs
Adding a Proxy to a Replicated Topology

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.

  1. On Sun OpenDS Standard Edition proxy instance 4, execute the gicadm create-catalog command.

  2. On Sun OpenDS Standard Edition proxy instance 4, run the commandsgicadm add-index cn, gicadm add-index sn, and gicadm add-index mail.

  3. On Sun OpenDS Standard Edition proxy instance 4, execute the gicadm associate command.

  4. 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

Figure 5
Adding a Proxy to a Replicated Topology
Adding a Proxy to a Replicated Topology