Configuring DS Replication with DS Tools

Overview

This page describes the process to configure bi-directional replication between two DS instances.

Prerequisites

• Install primary DS

• Import data into primary DS

• Install secondary DS

Preparing Backend

To check the current DS backends in the primary DS:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://primaryds.example.com \
    backend suffix list

To create a new DS backend in the secondary DS:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://secondaryds.example.com \
    backend create \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    --be-name=ca

Enabling Replication

To enable replication on primary DS:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://primaryds.example.com \
    replication enable \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    --role=supplier \
    --replica-id=1 \
    --bind-dn="cn=Replication Manager,cn=config" \
    --bind-passwd=Secret.123

To enable replication on secondary DS:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://secondaryds.example.com \
    replication enable \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    --role=supplier \
    --replica-id=2 \
    --bind-dn="cn=Replication Manager,cn=config" \
    --bind-passwd=Secret.123

Creating Replication Agreements

To create replication agreement on primary DS:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://primaryds.example.com \
    repl-agmt create \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    --host=secondaryds.example.com \
    --port=389 \
    --conn-protocol=LDAP \
    --bind-dn="cn=Replication Manager,cn=config" \
    --bind-passwd=Secret.123 \
    --bind-method=SIMPLE \
    primaryds-to-secondaryds

To create replication agreement on secondary DS:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://secondaryds.example.com \
    repl-agmt create \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    --host=primaryds.example.com \
    --port=389 \
    --conn-protocol=LDAP \
    --bind-dn="cn=Replication Manager,cn=config" \
    --bind-passwd=Secret.123 \
    --bind-method=SIMPLE \
    example-agreement-secondaryds-to-primaryds

Initializing Replication

To initialize the replication:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://primaryds.example.com \
    repl-agmt init \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    primaryds-to-secondaryds

Wait until the initialization is complete:

$ dsconf \
    -D "cn=Directory Manager" \
    -w Secret.123 \
    ldap://primaryds.example.com \
    repl-agmt init-status \
    --suffix=dc=ca,dc=pki,dc=example,dc=com \
    example-agreement-primaryds-to-secondaryds
Agreement successfully initialized.

See Also

• RHDS 11: Multi-Supplier Replication