Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 7. Configuring cascading replication using the web console

In a cascading replication scenario, one server, a hub, acts both as a consumer and a supplier. The hub is a read-only replica that maintains a changelog. It receives updates from the supplier and supplies these updates to a consumer. Use cascading replication for balancing heavy traffic loads or to keep suppliers based locally in geographically-distributed environments.

To prepare the hub.example.com host, enable replication. This process:

  • Configures the role of this server in the replication topology
  • Defines the suffix that is replicated
  • Creates the replication manager account the supplier uses to connect to this host

Perform this procedure on the hub that you want to add to the replication topology.

Prerequisites

  • You installed the Directory Server instance.
  • The database for the dc=example,dc=com suffix exists.
  • You are logged in to the instance in the web console.

Procedure

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.

  3. Enable replication:

    1. Click Enable Replication.

    2. Select Consumer in the Replication Role field, and enter the replication manager account and the password to create:

      replication enabling replication on hub
      View larger image
      replication enabling replication on hub

      These settings configure the host as a hub for the dc=example,dc=com suffix.

    3. Click Enable Replication.

Verification

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.
  3. If the Replica Role field contains the value Hub, replication is enabled, and the host is configured as a consumer.

To prepare the existing server as a supplier, you need to:

  • Enable replication for the suffix.
  • Create a replication agreement to the hub.
  • Initialize the hub.

Perform this procedure on the existing supplier in the replication topology.

Prerequisites

  • You enabled replication for the dc=example,dc=com suffix on the hub to join.
  • You are logged in to the instance in the web console.

Procedure

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.

  3. Enable replication:

    1. Click Enable Replication.

    2. Select Supplier in the Replication Role field, enter a replica ID, as well as the distinguished name (DN) and password of the replication manager account to create:

      replication enabling replication on supplier for multi supplier replication 1
      View larger image
      replication enabling replication on supplier for multi supplier replication 1

      These settings configure the host as a supplier for the dc=example,dc=com suffix and set the replica ID of this entry to 1.

      Important

      The replica ID must be a unique integer between 1 and 65534 for a suffix across all suppliers in the topology.

    3. Click Enable Replication.

  4. Add a replication agreement and initialize the new server:

    1. On the Agreements tab, click Create Agreement, and fill the fields:

      replication create replication agreement cascasing replication supplier to hub
      View larger image
      replication create replication agreement cascasing replication supplier to hub

      These settings create a replication agreement named example-agreement-supplier-to-hub. The replication agreement defines settings, such as the hub’s host name, protocol, and authentication information that the supplier uses when connecting and replicating data to this hub.

    2. Select Do Online Initialization in the Consumer Initialization field to automatically initialize the new server after saving the agreement.

    3. Click Save Agreement.

      After the agreement was created, Directory Server initializes hub.example.com. Depending on the amount of data to replicate, initialization can be time-consuming.

Verification

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.

  3. On the Agreements tab, verify the status of the agreement in the State column of the table.

    replication replication agreement successfully initialized
    View larger image
    replication replication agreement successfully initialized

To prepare the consumer.example.com host, enable replication. This process:

  • Configures the role of this server in the replication topology
  • Defines the suffix that is replicated
  • Creates the replication manager account the supplier uses to connect to this host

Perform this procedure on the consumer that you want to add to the replication topology.

Prerequisites

Procedure

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.
  3. Click Enable Replication.

  4. Select Consumer in the Replication Role field, and enter the replication manager account and the password to create:

    replication enabling replication on consumer
    View larger image
    replication enabling replication on consumer

    These settings configure the host as a consumer for the dc=example,dc=com suffix. Additionally, the server creates the cn=replication manager,cn=config user with the specified password and allows this account to replicate changes for the suffix to this host.

  5. Click Enable Replication.

Verification

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.
  3. If the Replica Role field contains the value Consumer, replication is enabled, and the host is configured as a consumer.

To prepare the hub, you need to:

  • Create a replication agreement to the consumer.
  • Initialize the consumer.

Perform this procedure on the hub in the replication topology.

Prerequisites

  • The hub is initialized, and replication from the supplier to the hub works.
  • You enabled replication for the dc=example,dc=com suffix on the hub.
  • You are logged in to the instance in the web console.

Procedure

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.

  3. Add a replication agreement and initialize the consumer:

    1. On the Agreements tab, click Create Agreement, and fill the fields:

      replication create replication agreement cascasing replication hub to consumer
      View larger image
      replication create replication agreement cascasing replication hub to consumer

      These settings create a replication agreement named example-agreement-hub-to-consumer. The replication agreement defines settings, such as the consumer’s host name, protocol, and authentication information that the hub uses when connecting and replicating data to this consumer.

    2. Select Do Online Initialization in the Consumer Initialization field to automatically initialize the consumer after saving the agreement.

    3. Click Save Agreement.

      After the agreement was created, Directory Server initializes consumer.example.com. Depending on the amount of data to replicate, initialization can be time-consuming.

Verification

  1. Open the Replication menu.
  2. Select the dc=example,dc=com suffix.

  3. On the Agreements tab, verify the status of the agreement in the State column of the table.

    replication replication agreement successfully initialized
    View larger image
    replication replication agreement successfully initialized
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat