<?xml version="1.0" encoding="utf-8"?>
|
<!--
|
! CDDL HEADER START
|
!
|
! The contents of this file are subject to the terms of the
|
! Common Development and Distribution License, Version 1.0 only
|
! (the "License"). You may not use this file except in compliance
|
! with the License.
|
!
|
! You can obtain a copy of the license at
|
! trunk/opends/resource/legal-notices/OpenDS.LICENSE
|
! or https://OpenDS.dev.java.net/OpenDS.LICENSE.
|
! See the License for the specific language governing permissions
|
! and limitations under the License.
|
!
|
! When distributing Covered Code, include this CDDL HEADER in each
|
! file and include the License file at
|
! trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,
|
! add the following below this CDDL HEADER, with the fields enclosed
|
! by brackets "[]" replaced with your own identifying information:
|
! Portions Copyright [yyyy] [name of copyright owner]
|
!
|
! CDDL HEADER END
|
!
|
!
|
! Copyright 2007-2009 Sun Microsystems, Inc.
|
! -->
|
<adm:managed-object name="replication-domain"
|
plural-name="replication-domains"
|
package="org.opends.server.admin.std"
|
xmlns:adm="http://www.opends.org/admin"
|
xmlns:ldap="http://www.opends.org/admin-ldap">
|
<adm:synopsis>
|
A
|
<adm:user-friendly-name />
|
comprises of several Directory Servers sharing the same synchronized
|
set of data.
|
</adm:synopsis>
|
<adm:tag name="replication" />
|
<adm:profile name="ldap">
|
<ldap:object-class>
|
<ldap:name>ds-cfg-replication-domain</ldap:name>
|
<ldap:superior>top</ldap:superior>
|
</ldap:object-class>
|
</adm:profile>
|
<adm:property name="replication-server" multi-valued="true"
|
mandatory="true">
|
<adm:synopsis>
|
Specifies the addresses of the Replication Servers within the
|
<adm:user-friendly-name />
|
to which the Directory Server should try to connect at startup
|
time.
|
</adm:synopsis>
|
<adm:description>
|
Addresses must be specified using the syntax: hostname:port
|
</adm:description>
|
<adm:syntax>
|
<adm:string>
|
<adm:pattern>
|
<adm:regex>^.+:[0-9]+$</adm:regex>
|
<adm:usage>HOST:PORT</adm:usage>
|
<adm:synopsis>
|
A host name followed by a ":" and a port number.
|
</adm:synopsis>
|
</adm:pattern>
|
</adm:string>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-replication-server</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="server-id" mandatory="true" read-only="true">
|
<adm:synopsis>
|
Specifies a unique identifier for the Directory Server within the
|
<adm:user-friendly-name />.
|
</adm:synopsis>
|
<adm:description>
|
Each Directory Server within the same
|
<adm:user-friendly-name />
|
must have a different server ID. A Directory Server which is a
|
member of multiple
|
<adm:user-friendly-plural-name />
|
may use the same server ID for each of its
|
<adm:user-friendly-name />
|
configurations.
|
</adm:description>
|
<adm:syntax>
|
<adm:integer lower-limit="1" upper-limit="65535"></adm:integer>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-server-id</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="base-dn" mandatory="true" read-only="true">
|
<adm:synopsis>
|
Specifies the base DN of the replicated data.
|
</adm:synopsis>
|
<adm:syntax>
|
<adm:dn />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-base-dn</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="window-size" advanced="true">
|
<adm:synopsis>
|
Specifies the window size that the Directory Server will use when
|
communicating with Replication Servers.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>100</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:integer />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-window-size</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="heartbeat-interval" advanced="true">
|
<adm:synopsis>
|
Specifies the heart-beat interval that the Directory Server will
|
use when communicating with Replication Servers.
|
</adm:synopsis>
|
<adm:description>
|
The Directory Server expects a regular heart-beat coming from
|
the Replication Server within the specified interval. If a
|
heartbeat is not received within the interval, the Directory
|
Server closes its connection and connects to another
|
Replication Server.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>10000ms</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:duration base-unit="ms" lower-limit="100" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-heartbeat-interval</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="isolation-policy">
|
<adm:synopsis>
|
Specifies the behavior of the Directory Server if a write
|
operation is attempted on the data within the
|
<adm:user-friendly-name />
|
when none of the configured Replication Servers are available.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>reject-all-updates</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:enumeration>
|
<adm:value name="accept-all-updates">
|
<adm:synopsis>
|
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 a
|
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.
|
</adm:synopsis>
|
</adm:value>
|
<adm:value name="reject-all-updates">
|
<adm:synopsis>
|
Indicates that all updates attempted on this
|
<adm:user-friendly-name />
|
are rejected when no Replication Server is available.
|
</adm:synopsis>
|
</adm:value>
|
</adm:enumeration>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-isolation-policy</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="assured-type" mandatory="false" advanced="true">
|
<adm:synopsis>
|
Defines the assured replication mode of the replicated domain.
|
</adm:synopsis>
|
<adm:description>
|
The assured replication can be disabled or enabled. When enabled, two
|
modes are available: Safe Data or Safe Read modes.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>not-assured</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:enumeration>
|
<adm:value name="not-assured">
|
<adm:synopsis>
|
Assured replication is not enabled. Updates sent for replication
|
(for being replayed on other LDAP servers in the topology) are sent
|
without waiting for any acknowledgment and the LDAP client call
|
returns immediately.
|
</adm:synopsis>
|
</adm:value>
|
<adm:value name="safe-data">
|
<adm:synopsis>
|
Assured replication is enabled in Safe Data mode: updates sent for
|
replication are subject to acknowledgment from the replication
|
servers that have the same group ID as the local server (defined
|
with the group-id property). The number of acknowledgments to expect
|
is defined by the assured-sd-level property. After acknowledgments
|
are received, LDAP client call returns.
|
</adm:synopsis>
|
</adm:value>
|
<adm:value name="safe-read">
|
<adm:synopsis>
|
Assured replication is enabled in Safe Read mode: updates sent for
|
replication are subject to acknowledgments from the LDAP servers in
|
the topology that have the same group ID as the local server
|
(defined with the group-id property). After acknowledgments are
|
received, LDAP client call returns.
|
</adm:synopsis>
|
</adm:value>
|
</adm:enumeration>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-assured-type</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="assured-sd-level" mandatory="false" advanced="true">
|
<adm:synopsis>
|
The level of acknowledgment for Safe Data assured sub mode.
|
</adm:synopsis>
|
<adm:description>
|
When assured replication is configured in Safe Data mode, this value
|
defines the number of replication servers (with the same group ID of the
|
local server) that should acknowledge the sent update before the LDAP
|
client call can return.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>1</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:integer lower-limit="1" upper-limit="127"></adm:integer>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-assured-sd-level</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="assured-timeout" mandatory="false" advanced="true">
|
<adm:synopsis>
|
The timeout value when waiting for assured replication acknowledgments.
|
</adm:synopsis>
|
<adm:description>
|
Defines the amount of milliseconds the server will wait for assured
|
acknowledgments (in either Safe Data or Safe Read assured replication
|
modes) before returning anyway the LDAP client call.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>2000ms</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:duration base-unit="ms" lower-limit="1" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-assured-timeout</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="group-id" mandatory="false" advanced="true">
|
<adm:synopsis>
|
The group ID associated with this replicated domain.
|
</adm:synopsis>
|
<adm:description>
|
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 its own one (the local server
|
group ID).
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>1</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:integer lower-limit="1" upper-limit="127"></adm:integer>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-group-id</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="referrals-url" multi-valued="true" mandatory="false"
|
advanced="true">
|
<adm:synopsis>
|
The URLs other LDAP servers should use to refer to the local server.
|
</adm:synopsis>
|
<adm:description>
|
URLs used by peer servers in the topology to refer to the local server
|
through LDAP referrals. If this attribute is not defined, every URLs
|
available to access this server will be used. If defined, only URLs
|
specified here will be used.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:undefined/>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string>
|
<adm:pattern>
|
<adm:regex>^[lL][dD][aA][pP][sS]?://.+$</adm:regex>
|
<adm:usage>LDAP URL</adm:usage>
|
<adm:synopsis>
|
A LDAP URL compliant with RFC 2255.
|
</adm:synopsis>
|
</adm:pattern>
|
</adm:string>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-referrals-url</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
</adm:managed-object>
|
