11.8. Temporarily Suspending Replication

By default, replication is enabled and active as soon as the replication agreement is created, and replication proceeds on the given schedule. There can be times when it is necessary to suspend replication, such as when a server is taken down for maintenance. An attribute can be added to the replication agreement entry which disables replication.

11.8.1. Disabling Replication

The nsds5ReplicaEnabled attribute on the replication entry sets whether the replication agreement is active. This attribute is missing by default and has a presumed value of on, meaning that replication is enabled.
To stop replication from a supplier, set the nsds5ReplicaEnabled attribute to off.
[root@server ~]# ldapmodify -D "cn=directory manager" -W -x -h supplier1.example.com

dn: cn=ExampleAgreement,cn=replica,cn=dc\=example\,dc\=com,cn=mapping tree,cn=config
changetype: modify
add: nsds5ReplicaEnabled
nsds5ReplicaEnabled: off

11.8.2. Re-enabling Replication

  1. Using ldapmodify, set the nsds5ReplicaEnabled attribute to on.
    [root@server ~]# ldapmodify -D "cn=directory manager" -W -x -h supplier1.example.com
    
    dn: cn=ExampleAgreement,cn=replica,cn=dc\=example\,dc\=com,cn=mapping tree,cn=config
    changetype: modify
    add: nsds5ReplicaEnabled
    nsds5ReplicaEnabled: on
    Since the default value for this parameter is true, it is also possible to remove the attribute from the replication agreement entry.
    changetype: modify
    remove: nsds5ReplicaEnabled
  2. Initiate an update, such as using the replicate_now.sh script as described in Section 11.16.2, “Forcing Replication Updates from the Command Line”.