WildFly Full 26.1 Model Reference

  1. home
  2. subsystem=infinispan
  3. cache-container
  4. distributed-cache

A distributed cache configuration.

Children (3)

  • component A configuration component of a cache.
    • backup-for A cache for which this cache acts as a backup (for use with cross site replication).
    • backups The remote backups for this cache.
    • expiration The cache expiration configuration.
    • locking The locking configuration of the cache.
    • partition-handling The partition handling configuration for distributed and replicated caches.
    • state-transfer The state transfer configuration for distributed and replicated caches.
    • transaction The cache transaction configuration.
  • memory Alias to the eviction configuration component
    • heap On-heap object-based memory configuration.
    • off-heap Off-heap memory configuration.
  • store A persistent store for a cache.
    • binary-jdbc The cache JDBC store configuration.
    • custom The cache store configuration.
    • file The cache file store configuration.
    • hotrod HotRod-based store using Infinispan Server instance to store data.
    • jdbc The cache JDBC store configuration.
    • mixed-jdbc The cache JDBC store configuration.
    • none A store-less configuration.
    • remote The cache remote store configuration.

Provided capabilities(11)

Name Dynamic Other provider points
org.wildfly.clustering.cache.service-provider-registry true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.infinispan.cache-container.cache.transport true /subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.cache.registry true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.cache.singleton-service-builder-factory true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.infinispan.cache-configuration true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.cache.singleton-service-configurator-factory true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.infinispan.cache true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.cache.group true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.cache.registry-entry true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.cache.registry-factory true /subsystem=infinispan/cache-container=*/local-cache=*
/subsystem=infinispan/cache-container=*/replicated-cache=*
/subsystem=infinispan/cache-container=*/scattered-cache=*
/subsystem=infinispan/cache-container=*/invalidation-cache=*
org.wildfly.clustering.infinispan.transport.channel true /subsystem=infinispan/cache-container=*/transport=jgroups

Attributes (38)

  • activations The number of cache node activations (bringing a node into memory from a cache store).
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • async-marshalling If enabled, this will cause marshalling of entries to be performed asynchronously.
    • Deprecated Since 4.0.0
    Deprecated. Asynchronous marshalling is no longer supported.
    Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • average-read-time Average time (in ms) for cache reads. Includes hits and misses.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • average-replication-time The average time taken to replicate data around the cluster.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • average-write-time Average time (in ms) for cache writes.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • batching If enabled, the invocation batching API will be made available for this cache.
    • Deprecated Since 3.0.0
    Deprecated. Replaced by BATCH transaction mode.
    Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • cache-status The status of the cache component.
    • Deprecated Since 11.0.0
    Deprecated. Always returns RUNNING.
    Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • capacity-factor Controls the proportion of entries that will reside on the local node, compared to the other nodes in the cluster.
    • Attribute Value
    Default Value 1.0
    Type DOUBLE
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • consistent-hash-strategy Defines the consistent hash strategy for the cache.
    • Deprecated Since 13.0.0
    Deprecated. Segment allocation is no longer customizable.
    Attribute Value
    Default Value INTER_CACHE
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Allowed Values INTER_CACHE
    INTRA_CACHE
  • elapsed-time Time (in secs) since cache started.
    • Deprecated Since 11.0.0
    Deprecated. Use time-since-start instead.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • hit-ratio The hit/miss ratio for the cache (hits/hits+misses).
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type DOUBLE
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • hits The number of cache attribute hits.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • indexing If enabled, entries will be indexed when they are added to the cache. Indexes will be updated as entries change or are removed.
    • Deprecated Since 4.0.0
    Deprecated. Has no effect.
    Attribute Value
    Default Value NONE
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Allowed Values NONE
    ALL
    PRIMARY_OWNER
  • indexing-properties Properties to control indexing behaviour
    • Deprecated Since 4.0.0
    Deprecated. Has no effect.
    Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • invalidations The number of cache invalidations.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • jndi-name The jndi-name to which to bind this cache instance.
    • Deprecated Since 6.0.0
    Deprecated. Will be ignored.
    Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • l1-lifespan Maximum lifespan of an entry placed in the L1 cache. This element configures the L1 cache behavior in 'distributed' caches instances. In any other cache modes, this element is ignored.
    • Attribute Value
    Default Value 0
    Type LONG
    Nillable true
    Expressions Allowed true
    Min 0
    Max -1
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • misses The number of cache attribute misses.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • mode Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
    • Deprecated Since 6.0.0
    Deprecated. This attribute will be ignored. All cache modes will be treated as SYNC. To perform asynchronous cache operations, use Infinispan's asynchronous cache API.
    Attribute Value
    Default Value SYNC
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Allowed Values SYNC
    ASYNC
  • module The module associated with this cache's configuration.
    • Deprecated Since 14.0.0
    Deprecated. Superseded by the modules attribute.
    Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • modules The set of modules associated with this cache's configuration.
    • Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • number-of-entries The number of entries in the cache including passivated entries.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • owners Number of cluster-wide replicas for each cache entry.
    • Attribute Value
    Default Value 2
    Type INT
    Nillable true
    Expressions Allowed true
    Min 1
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • passivations The number of cache node passivations (passivating a node from memory to a cache store).
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • queue-flush-interval In ASYNC mode, this attribute controls how often the asynchronous thread used to flush the replication queue runs. This should be a positive integer which represents thread wakeup time in milliseconds.
    • Deprecated Since 4.1.0
    Deprecated. This attribute will be ignored.
    Attribute Value
    Default Value 10
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • queue-size In ASYNC mode, this attribute can be used to trigger flushing of the queue when it reaches a specific threshold.
    • Deprecated Since 4.1.0
    Deprecated. This attribute will be ignored.
    Attribute Value
    Default Value 0
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • read-write-ratio The read/write ratio of the cache ((hits+misses)/stores).
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type DOUBLE
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • remote-timeout In SYNC mode, the timeout (in ms) used to wait for an acknowledgment when making a remote call, after which the call is aborted and an exception is thrown.
    • Attribute Value
    Default Value 10000
    Type LONG
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • remove-hits The number of cache attribute remove hits.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • remove-misses The number of cache attribute remove misses.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • replication-count The number of times data was replicated around the cluster.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • replication-failures The number of data replication failures.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • segments Controls the number of hash space segments which is the granularity for key distribution in the cluster. Value must be strictly positive.
    • Attribute Value
    Default Value 256
    Type INT
    Nillable true
    Expressions Allowed true
    Min 1
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • start The cache start mode, which can be EAGER (immediate start) or LAZY (on-demand start).
    • Deprecated Since 3.0.0
    Deprecated. Only LAZY mode is supported.
    Attribute Value
    Default Value LAZY
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Allowed Values LAZY
  • statistics-enabled If enabled, statistics will be collected for this cache
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
  • stores The number of cache attribute put operations.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • success-ratio The data replication success ratio (successes/successes+failures).
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type DOUBLE
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • time-since-reset Time (in secs) since cache statistics were reset.
    • Deprecated Since 11.0.0
    Deprecated. Use metric from corresponding runtime cache resource.
    Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only

Operations (2)

  • add Add a distributed cache to this cache container
    Request Parameter Type Required Expressions Allowed Default value Description
    capacity-factor DOUBLE false true 1.0 Controls the proportion of entries that will reside on the local node, compared to the other nodes in the cluster.
    l1-lifespan LONG false true 0 Maximum lifespan of an entry placed in the L1 cache. This element configures the L1 cache behavior in 'distributed' caches instances. In any other cache modes, this element is ignored.
    owners INT false true 2 Number of cluster-wide replicas for each cache entry.
    segments INT false true 256 Controls the number of hash space segments which is the granularity for key distribution in the cluster. Value must be strictly positive.
    remote-timeout LONG false true 10000 In SYNC mode, the timeout (in ms) used to wait for an acknowledgment when making a remote call, after which the call is aborted and an exception is thrown.
    statistics-enabled BOOLEAN false true false If enabled, statistics will be collected for this cache
    modules LIST false true The set of modules associated with this cache's configuration.
    consistent-hash-strategy STRING false true INTER_CACHE Defines the consistent hash strategy for the cache.
    async-marshalling BOOLEAN false true false If enabled, this will cause marshalling of entries to be performed asynchronously.
    mode STRING false true SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
    queue-flush-interval LONG false true 10 In ASYNC mode, this attribute controls how often the asynchronous thread used to flush the replication queue runs. This should be a positive integer which represents thread wakeup time in milliseconds.
    queue-size INT false true 0 In ASYNC mode, this attribute can be used to trigger flushing of the queue when it reaches a specific threshold.
    batching BOOLEAN false true false If enabled, the invocation batching API will be made available for this cache.
    indexing STRING false true NONE If enabled, entries will be indexed when they are added to the cache. Indexes will be updated as entries change or are removed.
    indexing-properties OBJECT false false Properties to control indexing behaviour
    jndi-name STRING false true The jndi-name to which to bind this cache instance.
    start STRING false true LAZY The cache start mode, which can be EAGER (immediate start) or LAZY (on-demand start).
    module STRING false true The module associated with this cache's configuration.
  • remove Remove a distributed cache from this cache container