Note: this component is designated "advanced", which means that objects of this type are not expected to be created or altered in most environments. If you believe that such a change is necessary, you may want to contact support in order to understand the potential impact of that change.
Replication Servers publish updates to Directory Server instances within a Replication Domain.
Replication Servers publish updates to Directory Server instances within a Replication Domain. They are created when replication is enabled using the dsreplication tool.
↓Relations to This Component
↓Properties
The following components have a direct composition relation to Replication Servers:
The properties supported by this managed object are as follows:
| Basic Properties: | Advanced Properties: |
|---|---|
| ↓ replication-server-id | ↓ je-property |
| ↓ replication-db-directory | ↓ replication-purge-delay |
| ↓ replication-port | ↓ target-database-size |
| ↓ compression-criteria | ↓ listen-on-all-addresses |
| ↓ gateway-priority | ↓ heartbeat-interval |
| ↓ remote-monitor-update-interval | |
| ↓ restricted-domain |
replication-server-id (Read-Only)
| 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 limit is 1. Upper limit is 65535 . |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | The path where the Replication Server stores all persistent information. |
| Default Value | changelogDb |
| Allowed Values | A filesystem path |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | The Directory Server must be restarted for changes to this setting to take effect. Modification requires that the Directory Server be stopped, the database directory manually relocated, and then the Directory Server restarted. While the Directory Server is stopped, the old database directory and its contents must be manually moved or copied to the new location. |
| Description | The port on which this Replication Server waits for connections from other Replication Servers or Directory Server instances. |
| Default Value | None |
| Allowed Values | An integer value. Lower limit is 1. Upper limit is 65535 . |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | This modification must also be made to the Server Instance representing this server in the topology registry. This ensures that the most up-to-date information is used by topology-related tools. |
| Description | Specifies when the replication traffic should be compressed. The replication traffic can be compressed to reduce the amount of data flowing through particular data links. |
| Default Value | remote |
| Allowed Values | always - Replication traffic is always compressed except when the replica and the replication server are in the same process. remote - Replication traffic compression is enabled when a replica or replication server communicates with a replication server in a different location. never - Replication traffic is never compressed. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the gateway priority of the Replication Server in the current location. The Replication Server acting as a gateway handles communication with servers in other locations. The highest priority value is 1 and the lowest value is 10. To prevent this Replication Server from ever assuming the gateway role, set the priority to 0. The gateway role is assumed by the Replication Server with the highest gateway priority. Multiple Replication Servers may, however, share the same priority value. In such case, the first Replication Server requesting the role will normally assume this role. See the Replication chapter in the Administration Guide for further details about the gateway election process. |
| Default Value | 5 |
| Allowed Values | An integer value. Lower limit is 0. Upper limit is 10 . |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
je-property (Advanced Property)
| Description | Specifies the database and environment properties for the Berkeley DB Java Edition database for the replication changelog. Any Berkeley DB Java Edition property can be specified using the following form: property-name=property-value. Refer to the Directory Server documentation for further information on related properties, their implications, and range values. The definitive identification of all the property parameters is available in the example.properties file of Berkeley DB Java Edition distribution. |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | Yes |
| Required | No |
| Admin Action Required | Changes to this configuration property will only take effect if the associated multimaster replication synchronization provider is disabled and re-enabled (or the Directory Server is restarted). |
replication-purge-delay (Advanced Property)
| Description | Changes are guaranteed to be maintained in the changelog database for at least this duration. Setting target-database-size can allow additional changes to be maintained up to the configured size on disk. The replication purge delay specifies the period after which the Directory Server purges changes in the replication server database. Any change that is older than the purge delay is removed from the replication server database regardless of whether the change has been applied. To ensure proper replication processing, you must have the same purge delay value set for all replication servers in the topology. |
| Default Value | 86400s |
| Allowed Values | A duration. Lower limit is 0 seconds. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | Lowering this value will result in the immediate loss of historical replication data. Other servers may enter lockdown mode if they have a larger purge delay and detect missing changes. |
target-database-size (Advanced Property)
| Description | The replication changelog database is allowed to grow up to this size even if changes are older than the configured replication-purge-delay. Setting this value allows additional changes to be retained in the changelog beyond the purge delay up to the configured total size on disk. It is possible that the changelog database size on disk exceeds this configured value since changes are never purged before the configured replication-purge-delay. To avoid exceeding the configured limit, the server will begin purging data when 95% of the configured limit is reached. If a backup of the replicationChanges backend is performed as a task, then the size of the database on disk could theoretically exceed this limit since database cleaning cannot occur during the backup. In practice, this will not occur unless replication-purge-delay and target-database-size are configured to very small values and/or the backup is throttled with the --maxMegabytesPerSecond option so that it takes an especially long time to complete. The server maintains a Gauge that will trigger an Alarm if the size on disk exceeds this limit. |
| Default Value | Data is purged immediately after the replication-purge-delay expires. |
| Allowed Values | A positive integer representing a size. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
listen-on-all-addresses (Advanced Property)
| Description | Indicates whether the Replication Server should listen on all addresses for this host. If set to FALSE, then the Replication Server will listen only to the address resolved from the hostname provided. |
| Default Value | true |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
heartbeat-interval (Advanced Property)
| Description | Specifies the heartbeat interval that the Directory Server will use when communicating with Replication Servers. The Directory Server expects a regular heartbeat coming from the Replication Server within the specified interval. If a heartbeat is not received within the interval, the Directory Server closes its connection. |
| Default Value | 1m |
| Allowed Values | A duration. Lower limit is 10000 milliseconds. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
remote-monitor-update-interval (Advanced Property)
| Description | Specifies the duration that topology monitor data will be cached before it is requested again from a remote server. Each replication server has topology monitor data for all other servers participating in replication. This value can be increased for topologies that include a large number servers to reduce the network communication overhead |
| Default Value | 5000ms |
| Allowed Values | A duration. Lower limit is 1000 milliseconds. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
restricted-domain (Advanced Property)
| Description | Specifies the base DN of domains that are only replicated between server instances that belong to the same replication set. By default, replication changes are propagated in the entire topology. In some cases, however, it is desirable to limit the scope of replication. The entry balancing feature, for example, allows the same base DN to be partitioned into multiple data sets. Changes within a data set may be replicated, while the same is not desired between data sets. |
| Default Value | None |
| Allowed Values | A valid DN. |
| Multi-Valued | Yes |
| Required | No |
| Admin Action Required | None. Modification requires no further action |