Configuration Reference Home
OpenDS - Replication Server

Replication Server

Replication Servers publish updates to Directory Servers within a Replication Domain.

Relations To this Component

The following components have a direct COMPOSITION relation TO Replication Servers :




This page describes the Replication Server:


Properties

A description of each property follows.


Basic Properties: Advanced Properties:
↓ assured-timeout ↓ queue-size
↓ degraded-status-threshold
↓ group-id
↓ replication-db-directory
↓ replication-port
↓ replication-purge-delay
↓ replication-server
↓ replication-server-id
↓ window-size

Basic Properties

assured-timeout

Description
The timeout value when waiting for assured mode acknowledgements. Defines the amount of milliseconds the replication server will wait for assured acknowledgements (in either Safe Data or Safe Read assured sub modes) before forgetting them and answer to the entity that sent an update and is waiting for acknowledgment.
Default Value
1000ms
Allowed Values
A duration Syntax. Lower limit is 1 milliseconds.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

degraded-status-threshold

Description
The number of pending changes as threshold value for putting a directory server in degraded status. This value represents a number of pending changes a replication server has in queue for sending to a directory server. Once this value is crossed, the matching directory server goes in degraded status. When number of pending changes goes back under this value, the directory server is put back in normal status. 0 means status analyzer is disabled and directory servers are never put in degraded status.
Default Value
5000
Allowed Values
An integer value. Lower value is 0.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

group-id

Description
The group id for the replication server. This value defines the group id of the replication server. The replication system of a LDAP server uses the group id of the replicated domain and tries to connect, if possible, to a replication with the same group id.
Default Value
1
Allowed Values
An integer value. Lower value is 1. Upper value is 127 .
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

replication-db-directory

Description
The path where the Replication Server stores all persistent information.
Default Value
changelogDb
Allowed Values
A String
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
Yes

replication-port

Description
The port on which this Replication Server waits for connections from other Replication Servers or Directory Servers.
Default Value
None
Allowed Values
An integer value. Lower value is 1. Upper value is 65535 .
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

replication-purge-delay

Description
The time (in seconds) after which the Replication Server erases all persistent information.
Default Value
86400s
Allowed Values
A duration Syntax. Lower limit is 0 seconds.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

replication-server

Description
Specifies the addresses of other Replication Servers to which this Replication Server tries to connect at startup time. Addresses must be specified using the syntax: hostname:port
Default Value
None
Allowed Values
A host name followed by a ":" and a port number.
Multi-valued
Yes
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

replication-server-id

Description
Specifies a unique identifier for the Replication Server. Each Replication Server must have a different server ID.
Default Value
None
Allowed Values
An integer value. Lower value is 1. Upper value is 65535 .
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
Yes

window-size

Description
Specifies the window size that the Replication Server uses when communicating with other Replication Servers.
Default Value
100
Allowed Values
An integer value. Lower value is 0.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No


Advanced Properties

queue-size

Description
Specifies the number of changes that are kept in memory for each Directory Server in the Replication Domain.
Default Value
10000
Allowed Values
An integer value. Lower value is 0.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
Yes
Read-only
No


LDAP Mapping

Each configuration property can be mapped to a specific LDAP attribute under the "cn=config" entry. The mappings that follow are provided for information only. In general, you should avoid changing the server configuration by manipulating the LDAP attributes directly.

Base DN
cn=replication server
objectclass name
ds-cfg-replication-server
objectclass superior
top

Property
LDAP attribute
assured-timeout
ds-cfg-assured-timeout
degraded-status-threshold
ds-cfg-degraded-status-threshold
group-id
ds-cfg-group-id
queue-size
ds-cfg-queue-size
replication-db-directory
ds-cfg-replication-db-directory
replication-port
ds-cfg-replication-port
replication-purge-delay
ds-cfg-replication-purge-delay
replication-server
ds-cfg-replication-server
replication-server-id
ds-cfg-replication-server-id
window-size
ds-cfg-window-size