Configuration Reference Home
OpenDS - Global Index Catalog Replication Domain

Global Index Catalog Replication Domain

A Global Index Catalog Replication Domain comprises of all of the Global Indexes of a Global Index Catalog sharing the same synchronized set of data.

The Global Index Catalog Replication Domain contains all of the information required to setup the replication between several instances.

Relations To this Component

The following components have a direct COMPOSITION relation TO Global Index Catalog Replication Domains :




This page describes the Global Index Catalog Replication Domain:


Properties

A description of each property follows.


Basic Properties: Advanced Properties:
↓ isolation-policy ↓ auto-sync-at-startup
↓ replication-server ↓ group-id
↓ server-id ↓ heartbeat-interval
↓ window-size

Basic Properties

isolation-policy

Description
Specifies the behavior of the instance if a write operation is attempted on the data within the Global Index Catalog Replication Domain when none of the configured Replication Servers are available.
Default Value
reject-all-updates
Allowed Values
accept-all-updates - Indicates that updates should be accepted even though it is not possible to send them to any Replication Server. Best effort is made to re-send those updates to Replication Servers when one of them is available, however those changes are at risk because they are only available from the historical information. This mode can also introduce high replication latency.

reject-all-updates - Indicates that all updates attempted on this Global Index Catalog Replication Domain are rejected when no Replication Server is available.


Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

replication-server

Description
Specifies the addresses of the Replication Servers within the Global Index Catalog Replication Domain to which the global index should try 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
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

server-id

Description
Specifies a unique identifier for the global index within the Global Index Catalog Replication Domain. Each instance within the same Global Index Catalog Replication Domain must have a different server ID. An instance which is a member of multiple Global Index Catalog Replication Domains may use the same server ID for each of its Global Index Catalog Replication Domain configurations.
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


Advanced Properties

auto-sync-at-startup

Description
Indicates if the Global Index Catalog Replication Domain should automatically retrieve the best suited global index catalog in the topology and initialize from it.
Default Value
true
Allowed Values
true
false
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
Yes
Read-only
No

group-id

Description
The group id associated with this replicated domain. This value defines the group id of the replicated domain. The replication system will preferably connect and send updates to replicate to a replication server with the same group id as it.
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
Yes
Read-only
No

heartbeat-interval

Description
Specifies the heart-beat interval that the instance will use when communicating with Replication Servers. The instance expects a regular heart-beat from the Replication Server within the specified interval. If a heartbeat is not received within this interval, the instance closes its connection and connects to another Replication Server.
Default Value
1000ms
Allowed Values
A duration Syntax. Lower limit is 100 milliseconds.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
Yes
Read-only
No

window-size

Description
Specifies the window size that the instance will use when communicating with 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
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=replicationdomain
objectclass name
ds-cfg-global-index-catalog-replication-domain
objectclass superior
top

Property
LDAP attribute
auto-sync-at-startup
ds-cfg-auto-sync-at-startup
group-id
ds-cfg-group-id
heartbeat-interval
ds-cfg-heartbeat-interval
isolation-policy
ds-cfg-isolation-policy
replication-server
ds-cfg-replication-server
server-id
ds-cfg-server-id
window-size
ds-cfg-window-size