Show Table of Contents
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" owners="2" 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
nameparameter provides a unique identifier for the cache. - The
modeparameter sets the clustered cache mode. Valid values areSYNC(synchronous) andASYNC(asynchronous). - The (optional)
segmentsparameter 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
startparameter specifies whether the cache starts when the server starts up or when it is requested or deployed. - The
ownersparameter indicates the number of nodes that will contain the hash segment. - If
statisticsare enabled at the container level, per-cache statistics can be selectively disabled for caches that do not require monitoring by setting thestatisticsattribute 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.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.