Solutions

Write operations in DS/OpenDJ (All versions) fail when replication servers are down

Last updated Apr 10, 2019

The purpose of this article is to provide assistance if DS/OpenDJ rejects all write operations when replication servers (RSs) are offline.


Symptoms

In a standalone RS topology (DS <-> RS <-> DS), you notice that write operations to the directory servers (add/modify, etc) fail when all RSs are down.

You will see an error similiar to the following when this happens:

ADD operation failed
Result Code: 53 (Unwilling to Perform) 
The Replication is configured for suffix dc=example,dc=com but was not able to connect to any Replication Server

Recent Changes

Replication servers (RSs) have been taken offline or shut down for another reason.

Causes

This is the expected behavior. Replication is only possible when at least one RS is up, since DS must be connected to an RS for it to take writes. If replication is configured, the default behavior of the DS is to reject any writes if no replication servers are found when an update is received, this is to prevent divergence between the DSs since it’s impossible to replicate those changes to other servers when the RSs are down or when they come back online.

Solution

This issue can be resolved by ensuring you always have at least one RS online that the DS can connect to.

Note

Setting the replication domain isolation-policy to accept-all-updates when all Replication Servers are offline, will cause divergence between the DSs. If you allow all updates, any writes occurring when the RS is down will not be replicated to other DSs even when the RSs come back online. There is no queuing of changes on a DS waiting for the Replication Server to come online, changes are managed as part of the Replication Servers "changelogDb" system. 

See Also

Directory server 1 was attempting to connect to replication server 2 but has disconnected in handshake phase error in DS 5 and OpenDJ 2.6.x, 3.0, 3.5, 3.5.1

How do I troubleshoot replication issues in DS/OpenDJ (All versions)?

How do I use the Access log to troubleshoot DS/OpenDJ (All versions)?

Replication in DS/OpenDJ

Administration Guide › Managing Data Replication

Related Training

ForgeRock Directory Services Core Concepts (DS-400)

Related Issue Tracker IDs

N/A



Copyright and TrademarksCopyright © 2019 ForgeRock, all rights reserved.

Recommended Books

Loading...