Red Hat SummitChapter 2. Configuring single-supplier replication using the web console
In a single-supplier replication environment, one writable supplier replicates data to one or multiple read-only consumers. For example, set up single-supplier replication if a suffix receives a large number of search requests but only a small number of write requests. To distribute the load, clients can then search for the suffix on read-only consumers and send write requests to the supplier.
This section assumes that you have an existing Directory Server instance running on a host named supplier.example.com that will act as a supplier in the replication topology to be set up. The procedures describe how to add a read-only consumer named consumer.example.com to the topology, and how to configure single-supplier replication for the dc=example,dc=com suffix.
2.1. Preparing the new consumer using the web console
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
- You installed the Directory Server instance. For details, see Setting up a new instance using the web console.
-
The database for the
dc=example,dc=comsuffix exists. - You are logged in to the instance in the web console.
Procedure
- Open the Replication menu.
-
Select the
dc=example,dc=comsuffix. - Click .
Select
Consumerin the Replication Role field, and enter the replication manager account and the password to create:These settings configure the host as a consumer for the
dc=example,dc=comsuffix. Additionally, the server creates thecn=replication manager,cn=configuser with the specified password and allows this account to replicate changes for the suffix to this host.- Click .
Verification
- Open the Replication menu.
-
Select the
dc=example,dc=comsuffix. -
If the Replica Role field contains the value
Consumer, replication is enabled, and the host is configured as a consumer.
2.2. Configuring the existing server as a supplier to the consumer using the web console
To prepare the supplier.example.com host, you need to:
- Enable replication for the suffix.
- Create a replication agreement to the consumer.
- Initialize the consumer.
Perform this procedure on the existing supplier in the replication topology.
Prerequisites
-
You enabled replication for the
dc=example,dc=comsuffix on the consumer. - You are logged in to the instance in the web console.
Procedure
- Open the Replication menu.
-
Select the
dc=example,dc=comsuffix. Enable replication:
- Click .
Select
Supplierin the Replication Role field, enter a replica ID, replication manager credentials, and leave the Bind Group DN field empty:These settings configure the host as a supplier for the
dc=example,dc=comsuffix and set the replica ID of this entry to1.ImportantThe replica ID must be a unique integer between
1and65534for a suffix across all suppliers in the topology.- Click .
Add a replication agreement and initialize the consumer:
On the Agreements tab, click , and fill the fields:
These settings create a replication agreement named
example-agreement. The replication agreement defines settings, such as the consumer’s host name, protocol, and authentication information that the supplier uses when connecting and replicating data to this consumer.-
Select
Do Online Initializationin the Consumer Initialization field to automatically initialize the consumer after saving the agreement. Click .
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
- Open the Replication menu.
-
Select the
dc=example,dc=comsuffix. On the Agreements tab, verify the status of the agreement in the State column of the table.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}