5.5. Configure Distribution Mode (Remote Client-Server Mode)

Distribution mode is a clustered mode in JBoss Data Grid. Distribution mode can be added to any cache container using the following:
<cache-container name="local" 
		 default-cache="default" >
	<distributed-cache name="default"
			   mode="{SYNC/ASYNC}"
			   segments="${NUMBER}"
			   start="EAGER">
		<locking isolation="NONE" 
			 acquire-timeout="30000"
			 concurrency-level="1000" 
			 striping="false" />
		<transaction mode="NONE" />
	</distributed-cache>
</cache-container>

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, refer to the appropriate chapter.
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 are SYNC (synchronous) and ASYNC (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 is 80.
  • The start parameter specifies whether the cache starts when the server starts up or when it is requested or deployed.