Package org.forgerock.opendj.server.config.server

Interface ReplicationDomainCfg

  • All Superinterfaces:
    Configuration
    public interface ReplicationDomainCfg
extends Configuration
    A server-side interface for querying Replication Domain settings.

    A Replication Domain comprises of several Directory Servers sharing the same synchronized set of data.

    • Method Detail

      • configurationClass

        Class<? extends ReplicationDomainCfg> configurationClass()
        Gets the configuration class associated with this Replication Domain.
        Specified by:
        configurationClass in interface Configuration
        Returns:
        Returns the configuration class associated with this Replication Domain.

      • addChangeListener

        void addChangeListener​(ConfigurationChangeListener<ReplicationDomainCfg> listener)
        Register to be notified when this Replication Domain is changed.
        Parameters:
        listener - The Replication Domain configuration change listener.

      • removeChangeListener

        void removeChangeListener​(ConfigurationChangeListener<ReplicationDomainCfg> listener)
        Deregister an existing Replication Domain configuration change listener.
        Parameters:
        listener - The Replication Domain configuration change listener.

      • getAssuredSdLevel

        int getAssuredSdLevel()
        Gets the "assured-sd-level" property.

        The level of acknowledgment for Safe Data assured sub mode.

        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.

        Returns:
        Returns the value of the "assured-sd-level" property.

      • getAssuredTimeout

        long getAssuredTimeout()
        Gets the "assured-timeout" property.

        The timeout value when waiting for assured replication acknowledgments.

        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.

        Returns:
        Returns the value of the "assured-timeout" property.

      • getAssuredType

        ReplicationDomainCfgDefn.AssuredType getAssuredType()
        Gets the "assured-type" property.

        Defines the assured replication mode of the replicated domain.

        The assured replication can be disabled or enabled. When enabled, two modes are available: Safe Data or Safe Read modes.

        Returns:
        Returns the value of the "assured-type" property.

      • getBaseDN

        org.forgerock.opendj.ldap.DN getBaseDN()
        Gets the "base-dn" property.

        Specifies the base DN of the replicated data.

        Returns:
        Returns the value of the "base-dn" property.

      • getChangetimeHeartbeatInterval

        long getChangetimeHeartbeatInterval()
        Gets the "changetime-heartbeat-interval" property.

        Specifies the heart-beat interval that the directory server will use when sending its local change time to the Replication Server.

        The directory server sends a regular heart-beat to the Replication within the specified interval. The heart-beat indicates the change time of the directory server to the Replication Server.

        Returns:
        Returns the value of the "changetime-heartbeat-interval" property.

      • getConflictsHistoricalPurgeDelay

        long getConflictsHistoricalPurgeDelay()
        Gets the "conflicts-historical-purge-delay" property.

        This delay indicates the time (in minutes) the domain keeps the historical information necessary to solve conflicts.When a change stored in the historical part of the user entry has a date (from its replication ChangeNumber) older than this delay, it is candidate to be purged. The purge is applied on 2 events: modify of the entry, dedicated purge task.

        Returns:
        Returns the value of the "conflicts-historical-purge-delay" property.

      • getFractionalExclude

        SortedSet<String> getFractionalExclude()
        Gets the "fractional-exclude" property.

        Allows to exclude some attributes to replicate to this server.

        If fractional-exclude configuration attribute is used, attributes specified in this attribute will be ignored (not added/modified/deleted) when an operation performed from another directory server is being replayed in the local server. Note that the usage of this configuration attribute is mutually exclusive with the usage of the fractional-include attribute.

        Returns:
        Returns an unmodifiable set containing the values of the "fractional-exclude" property.

      • getFractionalInclude

        SortedSet<String> getFractionalInclude()
        Gets the "fractional-include" property.

        Allows to include some attributes to replicate to this server.

        If fractional-include configuration attribute is used, only attributes specified in this attribute will be added/modified/deleted when an operation performed from another directory server is being replayed in the local server. Note that the usage of this configuration attribute is mutually exclusive with the usage of the fractional-exclude attribute.

        Returns:
        Returns an unmodifiable set containing the values of the "fractional-include" property.

      • getGroupId

        int getGroupId()
        Gets the "group-id" property.

        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 its own one (the local server group ID).

        Returns:
        Returns the value of the "group-id" property.

      • getHeartbeatInterval

        long getHeartbeatInterval()
        Gets the "heartbeat-interval" property.

        Specifies the heart-beat interval that the directory server will use when communicating with Replication Servers.

        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.

        Returns:
        Returns the value of the "heartbeat-interval" property.

      • getInitializationWindowSize

        int getInitializationWindowSize()
        Gets the "initialization-window-size" property.

        Specifies the window size that this directory server may use when communicating with remote Directory Servers for initialization.

        Returns:
        Returns the value of the "initialization-window-size" property.

      • getIsolationPolicy

        ReplicationDomainCfgDefn.IsolationPolicy getIsolationPolicy()
        Gets the "isolation-policy" property.

        Specifies the behavior of the directory server if a write operation is attempted on the data within the Replication Domain when none of the configured Replication Servers are available.

        Returns:
        Returns the value of the "isolation-policy" property.

      • isLogChangenumber

        boolean isLogChangenumber()
        Gets the "log-changenumber" property.

        Indicates if this server logs the ChangeNumber in access log.

        This boolean indicates if the domain should log the ChangeNumber of replicated operations in the access log.

        Returns:
        Returns the value of the "log-changenumber" property.

      • getReferralsUrl

        SortedSet<String> getReferralsUrl()
        Gets the "referrals-url" property.

        The URLs other LDAP servers should use to refer to the local server.

        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.

        Returns:
        Returns an unmodifiable set containing the values of the "referrals-url" property.

      • getReplicationServer

        SortedSet<String> getReplicationServer()
        Gets the "replication-server" property.

        Specifies the addresses of the Replication Servers within the Replication Domain to which the directory server should try to connect at startup time.

        Addresses must be specified using the syntax: hostname:port

        Returns:
        Returns an unmodifiable set containing the values of the "replication-server" property.

      • getServerId

        int getServerId()
        Gets the "server-id" property.

        Specifies a unique identifier for the directory server within the Replication Domain.

        Each directory server within the same Replication Domain must have a different server ID. A directory server which is a member of multiple Replication Domains may use the same server ID for each of its Replication Domain configurations.

        Returns:
        Returns the value of the "server-id" property.

      • isSolveConflicts

        boolean isSolveConflicts()
        Gets the "solve-conflicts" property.

        Indicates if this server solves conflict.

        This boolean indicates if this domain keeps the historical information necessary to solve conflicts. When set to false the server will not maintain historical information and will therefore not be able to solve conflict. This should therefore be done only if the replication is used in a single master type of deployment.

        Returns:
        Returns the value of the "solve-conflicts" property.

      • getSourceAddress

        InetAddress getSourceAddress()
        Gets the "source-address" property.

        If specified, the server will bind to the address before connecting to the remote server.

        The address must be one assigned to an existing network interface.

        Returns:
        Returns the value of the "source-address" property.

      • getWindowSize

        int getWindowSize()
        Gets the "window-size" property.

        Specifies the window size that the directory server will use when communicating with Replication Servers.

        This option may be deprecated and removed in future releases.

        Returns:
        Returns the value of the "window-size" property.

      • getExternalChangelogDomain

        ExternalChangelogDomainCfg getExternalChangelogDomain()
                                               throws ConfigException
        Gets the External Changelog Domain.
        Returns:
        Returns the External Changelog Domain.
        Throws:
        ConfigException - If the External Changelog Domain could not be found or it could not be successfully decoded.