6.5. Configure Distribution Mode

Procedure 6.1. The distributed-cache Element

<cache-container name="clustered" 
    default-cache="default" 
    statistics="true">
  <!-- Additional configuration information here -->
  <distributed-cache name="default"
      mode="SYNC"
      segments="20"
      start="EAGER"
      owners="2"
      statistics="true">
    <!-- Additional configuration information here -->
  </distributed-cache>
</cache-container>

<cache-container name="clustered" 
    default-cache="default" 
    statistics="true">
  <!-- Additional configuration information here -->
  <distributed-cache name="default"
      mode="SYNC"
      segments="20"
      start="EAGER"
      owners="2"
      statistics="true">
    <!-- Additional configuration information here -->
  </distributed-cache>
</cache-container>

1. The name parameter provides a unique identifier for the cache.
2. The mode parameter sets the clustered cache mode. Valid values are SYNC (synchronous) and ASYNC (asynchronous).
3. 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 20.
4. The start parameter specifies whether the cache starts when the server starts up or when it is requested or deployed.
5. The owners parameter indicates the number of nodes that will contain the hash segment.
6. 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.