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

Procedure 7.1. The distributed-cache Element

1. Add the Cache Name

   The name parameter provides a unique identifier for the cache.

   <cache-container name="clustered" 
   		 default-cache="default" 
   		 statistics="true">
   	<transport executor="infinispan-transport" lock-timeout="60000"/>
    	<distributed-cache name="default" />
   

2. Set the Clustered Cache Start Mode

   The mode parameter sets the clustered cache mode. Valid values are SYNC (synchronous) and ASYNC (asynchronous).

   <cache-container name="clustered" 
   		 default-cache="default" 
   		 statistics="true">
   	<transport executor="infinispan-transport" lock-timeout="60000"/>
   	<distributed-cache name="default"
   			   mode="SYNC" />
   

3. Specify Number of Segments

   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.

   <cache-container name="clustered" 
   		 default-cache="default" 
   		 statistics="true">
   	<transport executor="infinispan-transport" lock-timeout="60000"/>
   	<distributed-cache name="default"
   			   mode="SYNC"
   			   segments="20" />
   

4. Set the Cache Start Mode

   The start parameter specifies whether the cache starts when the server starts up or when it is requested or deployed.

   <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"/>
   
   

5. Per-cache Statistics

   If statistics are enabled at the container level, per-cache statistics can be selectively disabled for caches that do not require monitoring by setting the statistics attribute to false.

   <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">
   			...
   	</distributed-cache>
   </cache-container>