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.
The Replication Service Discovery Mechanism object inherits from Service Discovery Mechanism.
Replication Service Discovery Mechanisms depend on the following objects:
Use the --advanced option to access advanced properties.
| Synopsis | The bind DN for periodically reading replication server configurations |
| Description | The 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 | No |
| Read-Only | No |
| Synopsis | The clear-text bind password for periodically reading replication server configurations. |
| Description | The bind password must be the same on all replication and directory servers. |
| Default Value | None |
| Allowed Values | A string. |
| Multi-valued | No |
| Required | No |
| Admin Action Required | None |
| Advanced | No |
| Read-Only | No |
bind-password-environment-variable
| Synopsis | Specifies the name of the environment variable that contains the clear-text bind password for periodically reading replication server configurations. |
| Description | The bind password must be the same on all replication and directory servers. |
| Default Value | None |
| Allowed Values | A string. |
| Multi-valued | No |
| Required | No |
| Admin Action Required | None Changes to this property will take effect the next time that the Replication Service Discovery Mechanism is accessed. |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the path to the text file whose only contents should be a single line containing the clear-text bind password for periodically reading replication server configurations. |
| Description | The bind password must be the same on all replication and directory servers. |
| Default Value | None |
| Allowed Values | A string. |
| Multi-valued | No |
| Required | No |
| Admin Action Required | None Changes to this property will take effect the next time that the Replication Service Discovery Mechanism is accessed. |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the name of the Java property that contains the clear-text bind password for periodically reading replication server configurations. |
| Description | The bind password must be the same on all replication and directory servers. |
| Default Value | None |
| Allowed Values | A string. |
| Multi-valued | No |
| Required | No |
| Admin Action Required | None Changes to this property will take effect the next time that the Replication Service Discovery Mechanism is accessed. |
| Advanced | No |
| Read-Only | No |
| Synopsis | Interval between two replication server configuration discovery queries. |
| Description | 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. Lower limit: 1 seconds. |
| Multi-valued | No |
| Required | No |
| Admin Action Required | None |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the name of the key manager that should be used with this Replication Service Discovery Mechanism. |
| Default Value | None |
| Allowed Values | The name of an existing Key Manager Provider. The referenced key manager provider must be enabled when the Replication 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 | No |
| Read-Only | No |
| Synopsis | Replication domain group ID of preferred directory server replicas. |
| Description | 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. Lower limit: 0. |
| Multi-valued | No |
| Required | No |
| Admin Action Required | None |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the list of replication servers to contact periodically when discovering server replicas. |
| Description | Since the replication servers will be contacted to perform this administrative task, the administration port should be used to ensure timely responses in all circumstances. |
| Default Value | None |
| Allowed Values | A host name followed by a ":" and the administration port number. |
| Multi-valued | Yes |
| Required | Yes |
| Admin Action Required | None |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the nicknames (also called the aliases) of the keys or key pairs that the Replication 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. |
| Description | This is only applicable when the Replication 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 object must be disabled and re-enabled for changes to take effect. |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the name of the trust manager that should be used with the Replication Service Discovery Mechanism. |
| Default Value | None |
| Allowed Values | The name of an existing Trust Manager Provider. The referenced trust manager provider must be enabled when the Replication Service Discovery Mechanism is enabled. |
| Multi-valued | No |
| Required | Yes |
| 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 | No |
| Read-Only | No |
| Synopsis | Indicates whether the Replication Service Discovery Mechanism should use SSL. |
| Description | If enabled, the Replication 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 object must be disabled and re-enabled for changes to take effect. |
| Advanced | No |
| Read-Only | No |
| Synopsis | Indicates whether the Replication Service Discovery Mechanism should use Start TLS. |
| Description | If enabled, the Replication 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 object must be disabled and re-enabled for changes to take effect. |
| Advanced | No |
| Read-Only | No |
| Synopsis | Specifies the fully-qualified name of the Java class that provides the Replication Service Discovery Mechanism implementation. |
| Default Value | org.opends.server.discovery.ReplicationServiceDiscoveryMechanism |
| Allowed Values | A Java class that extends or implements: org.opends.server.discovery.ServiceDiscoveryMechanism |
| Multi-valued | No |
| Required | Yes |
| Admin Action Required | The object must be disabled and re-enabled for changes to take effect. |
| Advanced | Yes |
| Read-Only | No |