Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.

Chapter 7. Configuring cascading replication using the web console


Configure cascading replication by setting up a hub server that acts as both a consumer and a supplier in your topology. The hub server forwards updates to consumers, reducing the processing burden on the primary supplier, while ensuring consistent data synchronization between the consumers.

The hub is a read-only replica that maintains a changelog.

7.1. Preparing the new hub server using the web console

Enable replication on the hub.example.com host to configure cascading replication within your topology.

The process achieves the following:

  • 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

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:

      Preparing the new hub server

      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.

Configure an existing Directory Server instance as a supplier to a hub server to enable cascading replication. Define the supplier settings to send directory updates to the hub that then forwards changes to consumers reducing the processing load on the primary supplier.

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

  • Enable replication for the suffix.
  • Create a replication agreement that points 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:

      Configuring the existing server as a supplier to the hub server

      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:

      Creating a replication agreement from a supplier to a hub in cascasing replication topology

      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 agreement successful initialization

7.3. Preparing the new consumer of the hub using the web console

Prepare a new consumer instance to receive updates from a hub server in a cascading replication topology. Define the consumer role, configure replication manager credentials, and enable replication via the web console to ensure data synchronization.

Enabling replication on consumer.example.com achieves the following:

  • 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:

    Preparing the new consumer of the hub

    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.

Configure the hub server as a supplier for a consumer in Directory Server to enable cascading replication. Establishing this relationship enables the hub to forward directory updates to the consumer, ensuring data synchronization across the topology while reducing the processing load on the primary supplier.

To prepare the hub, you need to do the following:

  • Create a replication agreement that points 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:

      Creating a replication agreement from a hub to consumer in cascasing replication topology

      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 agreement successful initialization
Red Hat logoGithubredditYoutubeTwitter

Lernen

Testen, kaufen und verkaufen

Communitys

Über Red Hat

Wir liefern gehärtete Lösungen, die es Unternehmen leichter machen, plattform- und umgebungsübergreifend zu arbeiten, vom zentralen Rechenzentrum bis zum Netzwerkrand.

Mehr Inklusion in Open Source

Red Hat hat sich verpflichtet, problematische Sprache in unserem Code, unserer Dokumentation und unseren Web-Eigenschaften zu ersetzen. Weitere Einzelheiten finden Sie in Red Hat Blog.

Über Red Hat Dokumentation

Legal Notice

Theme

© 2026 Red Hat
Nach oben