Replication Server

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

Dependencies

The following objects have Replication Servers:

Basic Properties

advertised-listen-address

SynopsisThe advertised address(es) which clients should use for connecting to this Replication Server.
DescriptionMultiple addresses may be provided as separate values for this attribute. The meta-address 0.0.0.0 is not permitted.
Default Value

None

Allowed Values

A hostname or an IP address.

Multi-valued

Yes

Required

Yes

Admin Action Required

None

Advanced

No

Read-Only

No

changelog-enabled

SynopsisSpecifies whether the "cn=changelog" backend will be available to client applications.
Default Value

enabled

Allowed Values

disabled: The "cn=changelog" backend will not be available to client applications.

enabled: The "cn=changelog" backend will be available to client applications. It will support searches using changelog cookies and "change numbers" as per the internet draft, http://tools.ietf.org/html/draft-good-ldap-changelog-04. Change numbers are globally consistent across all servers. This mode requires additional CPU, disk accesses and storage, so it should not be used unless change number based browsing is required.

enabled-cookie-mode-only: The "cn=changelog" backend will be available to client applications. However, it will only support searches using changelog cookies. Changes are published immediately, and in an order which may vary from one server to another. This mode does not require additional server resources.

Multi-valued

No

Required

No

Admin Action Required

None

Advanced

No

Read-Only

No

changelog-enabled-excluded-domains

SynopsisSpecifies the base DNs of domains to exclude from the change number indexer when changelog is enabled.
Default Value

When changelog is enabled, searches using "change numbers" is available for all domains (in other words, change number indexer includes all domains).

Allowed Values

A valid DN.

Multi-valued

Yes

Required

No

Admin Action Required

None

Advanced

No

Read-Only

No

cipher-key-length

SynopsisSpecifies the key length in bits for the preferred cipher.
Default Value

128

Allowed Values

An integer.

Lower limit: 0.

Multi-valued

No

Required

No

Admin Action Required

None

Changes to this property take effect immediately but only affect cryptographic operations performed after the change.

Advanced

No

Read-Only

No

cipher-transformation

SynopsisSpecifies the cipher for the directory server. The syntax is "algorithm/mode/padding".
DescriptionThe full transformation is required: specifying only an algorithm and allowing the cipher provider to supply the default mode and padding is not supported, because there is no guarantee these default values are the same among different implementations. Some cipher algorithms, including RC4 and ARCFOUR, do not have a mode or padding, and hence must be specified using NONE for the mode field and NoPadding for the padding field. For example, RC4/NONE/NoPadding.
Default Value

AES/GCM/NoPadding

Allowed Values

A string.

Multi-valued

No

Required

No

Admin Action Required

None

Changes to this property take effect immediately but only affect cryptographic operations performed after the change.

Advanced

No

Read-Only

No

confidentiality-enabled

SynopsisIndicates whether the replication change-log should make records readable only by Directory Server. Throughput and disk space are affected by the more expensive operations taking place.
DescriptionConfidentiality is achieved by encrypting records on all domains managed by this replication server. Encrypting the records prevents unauthorized parties from accessing contents of LDAP operations. For complete protection, consider enabling secure communications between servers. Change number indexing is not affected by the setting.
Default Value

false

Allowed Values

true

false

Multi-valued

No

Required

No

Admin Action Required

None

Changes to this property take effect immediately but only affect operations performed after the change.

Advanced

No

Read-Only

No

degraded-status-threshold

SynopsisThe number of pending changes as threshold value for putting a directory server in degraded status.
DescriptionThis 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.

Lower limit: 0.

Multi-valued

No

Required

No

Admin Action Required

None

Advanced

No

Read-Only

No

listen-address

SynopsisThe network interface(s) on which this Replication Server should listen for incoming client connections.
DescriptionMultiple addresses may be provided as separate values for this attribute. If no values are provided, then the directory server will listen on all interfaces.
Default Value

0.0.0.0

Allowed Values

A hostname or an IP address.

Multi-valued

Yes

Required

No

Admin Action Required

None

Advanced

No

Read-Only

No

replication-db-directory

SynopsisThe 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

No

Read-Only

Yes

replication-port

SynopsisThe port on which this Replication Server waits for connections from other Replication Servers or Directory Servers.
Default Value

None

Allowed Values

An integer.

Lower limit: 1.

Upper limit: 65535.

Multi-valued

No

Required

Yes

Admin Action Required

None

Advanced

No

Read-Only

No

weight

SynopsisThe weight of the replication server.
DescriptionThe weight affected to the replication server. Each replication server of the topology has a weight. When combined together, the weights of the replication servers of a same group can be translated to a percentage that determines the quantity of directory servers of the topology that should be connected to a replication server. For instance imagine a topology with 3 replication servers (with the same group id) with the following weights: RS1=1, RS2=1, RS3=2. This means that RS1 should have 25% of the directory servers connected in the topology, RS2 25%, and RS3 50%. This may be useful if the replication servers of the topology have a different power and one wants to spread the load between the replication servers according to their power.
Default Value

1

Allowed Values

An integer.

Lower limit: 1.

Multi-valued

No

Required

No

Admin Action Required

None

Advanced

No

Read-Only

No

Advanced Properties

Use the --advanced option to access advanced properties.

disk-full-threshold

SynopsisThe free disk space threshold at which point a warning alert notification will be triggered and the replication server will disconnect from the rest of the replication topology.
DescriptionWhen the available free space on the disk used by the replication changelog falls below the value specified, this replication server will stop. Connected Directory Servers will fail over to another RS. The replication server will restart again as soon as free space rises above the low threshold.
Default Value

5% of the filesystem size, plus 1 GB

Allowed Values

Uses Size Syntax .

Multi-valued

No

Required

No

Admin Action Required

None

Advanced

Yes

Read-Only

No

disk-low-threshold

SynopsisThe free disk space threshold at which point a warning alert notification will be triggered.
DescriptionWhen the available free space on the disk used by the replication changelog falls below the value specified, a warning is sent and logged. Normal operation will continue but administrators are advised to take action to free some disk space.
Default Value

5% of the filesystem size, plus 5 GB

Allowed Values

Uses Size Syntax .

Multi-valued

No

Required

No

Admin Action Required

None

Advanced

Yes

Read-Only

No

Read a different version of :