Configuration Reference Home
Wren:DS Server - Replication Service Discovery Mechanism

Replication Service Discovery Mechanism

A Replication Service Discovery Mechanism returns the set of directory servers participating in a replication topology.

The Replication Service Discovery Mechanism specifies the replication servers whose configuration is periodically read to discover available replicas.

Parent Component

The Replication Service Discovery Mechanism component inherits from the Service Discovery Mechanism

Properties

A description of each property follows.


Basic Properties: Advanced Properties:
↓ bind-dn ↓ java-class
↓ bind-password
↓ discovery-interval
↓ key-manager-provider
↓ primary-group-id
↓ replication-server
↓ ssl-cert-nickname
↓ trust-manager-provider
↓ use-ssl
↓ use-start-tls

Basic Properties

bind-dn

Description
The bind DN for periodically reading replication server configurationsThe bind DN must be present on all replication servers and directory servers, it must be able to read the server configuration.
Default Value
None
Allowed Values
A valid DN.
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

bind-password

Description
The bind password for periodically reading replication server configurationsThe bind password must be the same on all replication and directory servers
Default Value
None
Allowed Values
A String
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

discovery-interval

Description
Interval between two replication server configuration discovery queries.Specifies how frequently to query a replication server configuration in order to discover information about available directory server replicas.
Default Value
60s
Allowed Values
A duration Syntax. Lower limit is 1 seconds.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

key-manager-provider

Description
Specifies the name of the key manager that should be used with this Service Discovery Mechanism.
Default Value
None
Allowed Values
The DN of any Key Manager Provider. The referenced key manager provider must be enabled when the Service Discovery Mechanism is enabled and configured to use SSL or StartTLS.
Multi-valued
No
Required
No
Admin Action Required
None. Changes to this property take effect immediately, but only for subsequent attempts to access the key manager provider for associated client connections.
Advanced Property
No
Read-only
No

primary-group-id

Description
Replication domain group ID of preferred directory server replicas.Directory server replicas with this replication domain group ID will be preferred over other directory server replicas. Secondary server replicas will only be used when all primary server replicas become unavailable.
Default Value
All the server replicas will be treated the same.
Allowed Values
An integer value. Lower value is 0.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

replication-server

Description
Specifies the list of replication servers to contact periodically when discovering server replicas.
Default Value
None
Allowed Values
A host name followed by a ":" and a port number.
Multi-valued
Yes
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

ssl-cert-nickname

Description
Specifies the nicknames (also called the aliases) of the keys or key pairs that the Service Discovery Mechanism should use when performing SSL communication. The property can be used multiple times (referencing different nicknames) when server certificates with different public key algorithms are used in parallel (for example, RSA, DSA, and ECC-based algorithms). When a nickname refers to an asymmetric (public/private) key pair, the nickname for the public key certificate and associated private key entry must match exactly. A single nickname is used to retrieve both the public key and the private key.This is only applicable when the Service Discovery Mechanism is configured to use SSL.
Default Value
Let the server decide.
Allowed Values
A String
Multi-valued
Yes
Required
No
Admin Action Required
The Replication Service Discovery Mechanism must be disabled and re-enabled for changes to this setting to take effect
Advanced Property
No
Read-only
No

trust-manager-provider

Description
Specifies the name of the trust manager that should be used with the Service Discovery Mechanism.
Default Value
Use the trust manager provided by the JVM.
Allowed Values
The DN of any Trust Manager Provider. The referenced trust manager provider must be enabled when the Service Discovery Mechanism is enabled and configured to use SSL or StartTLS.
Multi-valued
No
Required
No
Admin Action Required
None. Changes to this property take effect immediately, but only for subsequent attempts to access the trust manager provider for associated client connections.
Advanced Property
No
Read-only
No

use-ssl

Description
Indicates whether the Service Discovery Mechanism should use SSL.If enabled, the Service Discovery Mechanism will use SSL to encrypt communication with the clients.
Default Value
false
Allowed Values
true
false
Multi-valued
No
Required
No
Admin Action Required
The Replication Service Discovery Mechanism must be disabled and re-enabled for changes to this setting to take effect
Advanced Property
No
Read-only
No

use-start-tls

Description
Indicates whether the Service Discovery Mechanism should use Start TLS.If enabled, the Service Discovery Mechanism will use Start TLS to encrypt communication with remote servers.
Default Value
false
Allowed Values
true
false
Multi-valued
No
Required
No
Admin Action Required
The Replication Service Discovery Mechanism must be disabled and re-enabled for changes to this setting to take effect
Advanced Property
No
Read-only
No


Advanced Properties

java-class

Description
Specifies the fully-qualified name of the Java class that provides the Replication Service Discovery Mechanism implementation.
Default Value
org.opends.server.backends.proxy.ReplicationServiceDiscoveryMechanism
Allowed Values
A java class that implements or extends the class(es) :
org.opends.server.backends.proxy.ServiceDiscoveryMechanism
Multi-valued
No
Required
Yes
Admin Action Required
The Replication Service Discovery Mechanism must be disabled and re-enabled for changes to this setting to take effect
Advanced Property
Yes
Read-only
No