8.3. Configure Replication Mode (Remote Client-Server Mode)
Replication mode is a clustered cache mode in Red Hat JBoss Data Grid. Replication mode can be added to any cache container using the following procedure.
Procedure 8.1. The replicated-cache
Element
<cache-container name="clustered" default-cache="default" statistics="true"> <transport executor="infinispan-transport" lock-timeout="60000"/> <replicated-cache name="default" mode="SYNC" start="EAGER" statistics="true"> <transaction mode="NONE" /> </replicated-cache> </cache-container>
Important
JGroups must be appropriately configured for clustered mode before attempting to load this configuration.
The
replicated-cache
element configures settings for the distributed cache using the following parameters:
- The
name
parameter provides a unique identifier for the cache. - The
mode
parameter sets the clustered cache mode. Valid values areSYNC
(synchronous) andASYNC
(asynchronous). - The
start
parameter specifies whether the cache starts when the server starts up or when it is requested or deployed. - If
statistics
are enabled at the container level, per-cache statistics can be selectively disabled for caches that do not require monitoring by setting thestatistics
attribute tofalse
. - The
transaction
element sets up the transaction mode for the replicated cache.Important
In Remote Client-Server mode, the transactions element is set toNONE
unless JBoss Data Grid is used in a compatibility mode where the cluster contains both JBoss Data Grid server and library instances. In this case, if transactions are configured in the library mode instance, they must also be configured in the server instance.
For details about the
cache-container
and locking
, see the appropriate chapter.