7.5. Configure Distribution Mode (Remote Client-Server Mode)
Distribution mode is a clustered mode in Red Hat JBoss Data Grid. Distribution mode can be added to any cache container using the following procedure:
Procedure 7.1. The distributed-cache
Element
<cache-container name="clustered" default-cache="default" statistics="true"> <transport executor="infinispan-transport" lock-timeout="60000"/> <distributed-cache name="default" mode="SYNC" segments="20" start="EAGER" statistics="true"> <!-- Additional configuration information here --> </distributed-cache> </cache-container>
The
distributed-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 (optional)
segments
parameter specifies the number of hash space segments per cluster. The recommended value for this parameter is ten multiplied by the cluster size and the default value is20
. - 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
.
Important
JGroups must be appropriately configured for clustered mode before attempting to load this configuration.
For details about the
cache-container
, locking
, and transaction
elements, see the appropriate chapter.