Creating and Changing Replication Agreements

A replication agreement is a set of parameters on a supplier that configures and controls how updates are sent to a given consumer. The replication agreement must be created on the supplier replicated suffix that is sending updates to its consumer. You must create a replication agreement on the supplier for every consumer that you want updated.

To Create a Replication Agreement

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

If you use DSCC to create a new replication agreement, you can choose to copy some or all replication agreement configuration settings from an existing replication agreement.

1. From your master server, create a replication agreement for each consumer that you want to replicate to.

   $ dsconf create-repl-agmt -h host -p port suffix-DN consumer-host:consumer-port\
    [consumer-host:consumer-port]

   For example:

   $ dsconf create-repl-agmt -h host1 -p 1389 dc=example,dc=com host2:1389

   To list existing replication agreements by using the command line, use the dsconf list-repl-agmts command.

   ---

   Note - If you change the port number on a master when replication is running, you do not need to reinitialize the servers. However, the old replication agreement that pointed to the old address (host:old-port) is no longer useful. If you want replication to continue as it did before the port number was changed, you must create a new agreement with the new address (host:new-port).

   ---

2. Check that the replication agreement has been created correctly.

   $ dsconf show-repl-agmt-status -h host -p port suffix-DN consumer-host:consumer-port

3. If the authentication status is not OK, run the dsconf accord-repl-agmt command.

   ---

   Note - Only use the command dsconf accord-repl-agmt if you are using the default replication manager. If you have created a new replication manager, do not use this command because it overwrites some required settings.

   ---

   The dsconf accord-repl-agmt command ensures that both the supplier and destination servers share the same replication authentication settings.

   $ dsconf accord-repl-agmt -h host -p port suffix-DN consumer-host:consumer-port

   For example:

   $ dsconf accord-repl-agmt -h host2 -p 1389 dc=example,dc=com host1:1389

To Change the Destination of a Replication Agreement

This procedure changes the remote replica pointed to by an existing replication agreement. The suffix DN and configuration of the existing agreement remain the same.

• Change the host name and port number of the remote replica in the replication agreement.

  $ dsconf change-repl-dest -h host -p port suffix-DN host:port new-host:new-port

  If this command is run with the -A protocol option, you can change the authentication protocol that is used by replication.