urn:infinispan:config:8.5

infinispan

Defines the configuration for Infinispan, for the cache manager configuration, for the default cache, and for named caches.

jgroups?

Defines JGroups stacks.

Defines JGroups transport stacks.
Name Type Default Description
transport string org.infinispan.remoting.transport.jgroups.JGroupsTransport Class that represents a network transport. Must implement org.infinispan.remoting.transport.Transport.

stack-file+

Defines an individual JGroups stack, pointing to the file containing its definition.

Name Type Default Description
name string Name of the stack, to be referenced by transport's stack attribute.
path string Path of JGroups configuration file containing stack definition.

threads?

Defines the threading subsystem.

The threading subsystem, used to declare manageable thread pools and resources.

thread-factory*

A thread factory (implementing java.util.concurrent.ThreadFactory). The "name" attribute is the bean name of the created thread factory. The optional "priority" attribute may be used to specify the thread priority of created threads. The optional "group-name" attribute specifies the name of a the thread group to create for this thread factory. The "thread-name-pattern" is the template used to create names for threads. The following patterns may be used: %% - emit a percent sign %t - emit the per-factory thread sequence number %g - emit the global thread sequence number %f - emit the factory sequence number %i - emit the thread ID %G - emit the thread group name

Name Type Default Description
name string
group-name string
thread-name-pattern string
priority string

blocking-bounded-queue-thread-pool*

A thread pool executor with a bounded queue. Such a thread pool has a core size and a queue with an upper bound. When a task is submitted, if the number of running threads is less than the core size, a new thread is created. Otherwise, the task is placed in queue. If too many tasks are allowed to be submitted to this type of executor, an out of memory condition may occur. The "name" attribute is the bean name of the created executor. The "max-threads" attribute must be used to specify the maximum thread pool size. The "core-threads" attribute defines the number of threads to keep in the pool. The nested "keepalive-time" element may used to specify the amount of time that pool threads should be kept running when idle; if not specified, threads will run until the executor is shut down. The "thread-factory" element specifies the bean name of a specific thread factory to use to create worker threads.

Name Type Default Description
name string
thread-factory string
max-threads int
core-threads int
keepalive-time string
queue-length string

cached-thread-pool*

A thread pool executor that creates new threads as needed, but will reuse previously constructed threads when they are available. The "name" attribute is the bean name of the created executor. The "thread-factory" element specifies the bean name of a specific thread factory to use to create worker threads.

Name Type Default Description
name string
thread-factory string

scheduled-thread-pool*

A thread pool executor that creates a single-threaded executor that can schedule commands to run after a given delay, or to execute periodically. The "name" attribute is the bean name of the created executor. The "thread-factory" element specifies the bean name of a specific thread factory to use to create worker threads.

Name Type Default Description
name string
thread-factory string

cache-container

Defines an embedded cache container.

Name Type Default Description
name string Uniquely identifies this cache container.
aliases Unused XML attribute
jndi-name string Unused XML attribute
default-cache string Indicates the default cache for this cache container
start FIXME Unused XML attribute
async-executor string Defines the executor used for asynchronous cache operations.
listener-executor string Defines the executor used for asynchronous cache listener notifications.
eviction-executor string DEPRECATED Defines the scheduled executor used for evictions. The expiration-executor type should be used instead.
expiration-executor string Defines the scheduled executor used for expirations.
persistence-executor string Configuration for the executor service used when interacting with the persistent store.
state-transfer-executor string Configuration for the executor service used when applying state from other nodes during the state transfer.
module string org.jboss.as.clustering.infinispan Unused XML attribute
statistics boolean true Determines whether or not the cache container should collect statistics. Keep disabled for optimal performance.
shutdown-hook
DEFAULT Use the default shutdown hook behaviour (REGISTER)
REGISTER Register a shutdown hook
DONT_REGISTER Don't register a shutdown hook
Behavior of the JVM shutdown hook registered by the cache

transport?

Overrides the transport characteristics for this cache container.

Name Type Default Description
stack string Defines the jgroups stack used by the transport.
cluster string Defines the name for the underlying group communication cluster.
executor string Defines the executor used for asynchronous transport communication.
total-order-executor string Configuration for the total order executor service used to concurrent validate non conflicting transactions.
remote-command-executor string Configuration for the executor service used to execute remote commands. Use org.infinispan.executors.WithinThreadExecutorFactory to disable.
lock-timeout long 240000 Infinispan uses a distributed lock to maintain a coherent transaction log during state transfer or rehashing, which means that only one cache can be doing state transfer or rehashing at the same time. This constraint is in place because more than one cache could be involved in a transaction. This timeout controls the time to wait to acquire a distributed lock.
node-name string Name of the current node. This is a friendly name to make logs, etc. make more sense. Defaults to a combination of host name and a random number (to differentiate multiple nodes on the same host)
machine string The id of the machine where this node runs.
rack string The id of the rack where this node runs.
site string The id of the site where this node runs.
initial-cluster-size int The minimum number of nodes that must join the cluster for the cache manager to start
initial-cluster-timeout long The amount of time in milliseconds to wait for a cluster with sufficient nodes to form. Defaults to 60000

security?

Configures security for this cache container.

authorization?

Configures the global authorization role to permission mapping. The presence of this element in the configuration implicitly enables authorization.

Name Type Default Description
audit-logger string Class of the audit logger.

identity-role-mapper

Uses the identity role mapper where principal names are converted as-is into role names.

common-name-role-mapper

Uses the common name role mapper which assumes principal names are in Distinguished Name format and extracts the Common Name to use as a role

cluster-role-mapper

Uses the cluster role mapper which stores the principal to role mappings within the cluster registry.

custom-role-mapper

Uses a custom role mapper.

Name Type Default Description
class string Class of the custom principal to role mapper

role*

Defines a new role name and assigns permissions to it.

Name Type Default Description
name string Defines the name of the role.
permissions
LIFECYCLE Allows control of a cache's lifecycle (i.e. starting and stopping a cache)
READ Allows reading data from a cache
WRITE Allows writing data to a cache
EXEC Allows performing task execution (e.g. distributed executors, map/reduce) on a cache
LISTEN Allows attaching listeners to a cache
BULK_READ Allows bulk-read operations (e.g. obtaining all the keys in a cache)
BULK_WRITE Allows bulk-write operations (e.g. clearing a cache)
ADMIN Allows performing "administrative" operations on a cache
ALL Aggregate permission which implies all of the others
ALL_READ Aggregate permission which implies all read permissions (READ and BULK_READ)
ALL_WRITE Aggregate permission which implies all write permissions (WRITE and BULK_WRITE)
NONE Permission which means no permissions
Defines the list of permissions for the role.

serialization?

Specifies how data serialization will be performed by the cache container.

Name Type Default Description
marshaller string org.infinispan.marshall.core.VersionAwareMarshaller Fully qualified name of the marshaller to use. It must implement org.infinispan.marshall.StreamingMarshaller
version string 71 Largest allowable version to use when marshalling internal state. Set this to the lowest version cache instance in your cluster to ensure compatibility of communications. However, setting this too low will mean you lose out on the benefit of improvements in newer versions of the marshaller.

advanced-externalizer*

AdvancedExternalizer provides an alternative way to provide externalizers for marshalling/unmarshalling user defined classes that overcome the deficiencies of the more user-friendly externalizer definition model explained in Externalizer.

Name Type Default Description
class string Class of the custom externalizer
id int Id of the custom externalizer

jmx?

Defines JMX management details.

Name Type Default Description
domain string org.infinispan If JMX statistics are enabled then all 'published' JMX objects will appear under this name. This is optional, if not specified an object name will be created for you by default.
mbean-server-lookup string org.infinispan.jmx.PlatformMBeanServerLookup Class that will attempt to locate a JMX MBean server to bind to. Defaults to using the platform MBean server.
duplicate-domains boolean false If true, multiple cache manager instances could be configured under the same configured JMX domain. Each cache manager will in practice use a different JMX domain that has been calculated based on the configured one by adding an incrementing index to it.

property*

A jmx property with name and value to be passed to the MBean Server lookup instance.

global-state?

Defines the global state persistence configuration. If this element is not present, global state persistence will be disabled.

persistent-location?

Defines the filesystem path where persistent state data which needs to survive container restarts should be stored. The data stored at this location is required for graceful shutdown and restore. This path must NOT be shared among multiple instances. Defaults to the user.dir system property which usually is where the application was started. This value should be overridden to a more appropriate location.

Name Type Default Description
relative-to string jboss.server.data.dir Ignored in embedded mode.
path string Defines the path where global state for this cache-container will be stored.

shared-persistent-location?

Defines the filesystem path where shared persistent state data which needs to survive container restarts should be stored. This path can be safely shared among multiple instances. Defaults to the user.dir system property which usually is where the application was started. This value should be overridden to a more appropriate location.

Name Type Default Description
relative-to string jboss.server.data.dir Ignored in embedded mode.
path string Defines the path where global state for this cache-container will be stored.

temporary-location?

Defines the filesystem path where temporary state should be stored. Defaults to the value of the java.io.tmpdir system property.

Name Type Default Description
relative-to string jboss.server.data.dir Ignored in embedded mode.
path string Defines the path where global state for this cache-container will be stored.

immutable-configuration-storage

An immutable configuration storage.

volatile-configuration-storage

A non-persistent configuration storage.

overlay-configuration-storage

A persistent configuration storage which saves runtime configurations to the persistent-location.

managed-configuration-storage

A persistent configuration storage for managed environments. This doesn't work in embedded mode.

custom-configuration-storage

Uses a custom configuration storage implementation.

Name Type Default Description
class string Class of the custom configuration storage implementation.

local-cache

Defines a LOCAL mode cache.

Name Type Default Description
simple-cache FIXME false This cache will be using optimized (faster) implementation that does not support transactions/invocation batching, persistence, custom interceptors, indexing, store-as-binary or compatibility. Also, this type of cache does not support Map-Reduce jobs or Distributed Executor framework.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

local-cache-configuration

Defines a LOCAL mode cache configuration.

Name Type Default Description
simple-cache FIXME false This cache will be using optimized (faster) implementation that does not support transactions/invocation batching, persistence, custom interceptors, indexing, store-as-binary or compatibility. Also, this type of cache does not support Map-Reduce jobs or Distributed Executor framework.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

replicated-cache

Defines a REPL_* mode cache.

Name Type Default Description
segments int 256 Number of hash space segments (per cluster). The default value is 256, and should be at least 20 * cluster size.
consistent-hash-factory string The factory to use for generating the consistent hash. Must implement `org.infinispan.distribution.ch.ConsistentHashFactory`. E.g. `org.infinispan.distribution.ch.impl.SyncConsistentHashFactory` can be used to guarantee that multiple distributed caches use exactly the same consistent hash, which for performance reasons is not guaranteed by the default consistent hash factory instance used.
key-partitioner string The name of the key partitioner class. Must implement `org.infinispan.distribution.ch.KeyPartitioner`. A custom key partitioner can be used as an alternative to grouping, to guarantee that some keys are located in the same segment (and thus their primary owner is the same node). Since 8.2.

state-transfer?

The state transfer configuration for distribution and replicated caches.

Name Type Default Description
enabled boolean true If enabled, this will cause the cache to ask neighboring caches for state when it starts up, so the cache starts 'warm', although it will impact startup time.
timeout long 240000 The maximum amount of time (ms) to wait for state from neighboring caches, before throwing an exception and aborting startup.
chunk-size integer 512 The number of cache entries to batch in each transfer.
await-initial-transfer boolean true If enabled, this will cause the cache to wait for initial state transfer to complete before responding to requests.
Name Type Default Description
mode
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
remote-timeout long 15000 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.

partition-handling?

Configures the way this cache reacts to node crashes and split brains.

Name Type Default Description
enabled boolean Deprecated, use type instead. Enable/disable the partition handling functionality. Defaults to false.
when-split
DENY_READ_WRITES If the partition does not have all owners for a given segment, both reads and writes are denied for all keys in that segment.
ALLOW_READS Allows reads for a given key if it exists in this partition, but only allows writes if this partition contains all owners of a segment.
ALLOW_READ_WRITES Allow entries on each partition to diverge, with conflicts resolved during merge.
ALLOW_READ_WRITES The type of actions that are possible when a split brain scenario is encountered.
merge-policy PREFERRED_ALWAYS The entry merge policy which should be applied on partition merges.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

replicated-cache-configuration

Defines a REPL_* mode cache configuration.

Name Type Default Description
segments int 256 Number of hash space segments (per cluster). The default value is 256, and should be at least 20 * cluster size.
consistent-hash-factory string The factory to use for generating the consistent hash. Must implement `org.infinispan.distribution.ch.ConsistentHashFactory`. E.g. `org.infinispan.distribution.ch.impl.SyncConsistentHashFactory` can be used to guarantee that multiple distributed caches use exactly the same consistent hash, which for performance reasons is not guaranteed by the default consistent hash factory instance used.
key-partitioner string The name of the key partitioner class. Must implement `org.infinispan.distribution.ch.KeyPartitioner`. A custom key partitioner can be used as an alternative to grouping, to guarantee that some keys are located in the same segment (and thus their primary owner is the same node). Since 8.2.

state-transfer?

The state transfer configuration for distribution and replicated caches.

Name Type Default Description
enabled boolean true If enabled, this will cause the cache to ask neighboring caches for state when it starts up, so the cache starts 'warm', although it will impact startup time.
timeout long 240000 The maximum amount of time (ms) to wait for state from neighboring caches, before throwing an exception and aborting startup.
chunk-size integer 512 The number of cache entries to batch in each transfer.
await-initial-transfer boolean true If enabled, this will cause the cache to wait for initial state transfer to complete before responding to requests.
Name Type Default Description
mode
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
remote-timeout long 15000 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.

partition-handling?

Configures the way this cache reacts to node crashes and split brains.

Name Type Default Description
enabled boolean Deprecated, use type instead. Enable/disable the partition handling functionality. Defaults to false.
when-split
DENY_READ_WRITES If the partition does not have all owners for a given segment, both reads and writes are denied for all keys in that segment.
ALLOW_READS Allows reads for a given key if it exists in this partition, but only allows writes if this partition contains all owners of a segment.
ALLOW_READ_WRITES Allow entries on each partition to diverge, with conflicts resolved during merge.
ALLOW_READ_WRITES The type of actions that are possible when a split brain scenario is encountered.
merge-policy PREFERRED_ALWAYS The entry merge policy which should be applied on partition merges.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

invalidation-cache

Defines an INVALIDATION_* mode cache.

Name Type Default Description
mode
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
remote-timeout long 15000 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.

partition-handling?

Configures the way this cache reacts to node crashes and split brains.

Name Type Default Description
enabled boolean Deprecated, use type instead. Enable/disable the partition handling functionality. Defaults to false.
when-split
DENY_READ_WRITES If the partition does not have all owners for a given segment, both reads and writes are denied for all keys in that segment.
ALLOW_READS Allows reads for a given key if it exists in this partition, but only allows writes if this partition contains all owners of a segment.
ALLOW_READ_WRITES Allow entries on each partition to diverge, with conflicts resolved during merge.
ALLOW_READ_WRITES The type of actions that are possible when a split brain scenario is encountered.
merge-policy PREFERRED_ALWAYS The entry merge policy which should be applied on partition merges.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

invalidation-cache-configuration

Defines an INVALIDATION_* mode cache configuration.

Name Type Default Description
mode
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
remote-timeout long 15000 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.

partition-handling?

Configures the way this cache reacts to node crashes and split brains.

Name Type Default Description
enabled boolean Deprecated, use type instead. Enable/disable the partition handling functionality. Defaults to false.
when-split
DENY_READ_WRITES If the partition does not have all owners for a given segment, both reads and writes are denied for all keys in that segment.
ALLOW_READS Allows reads for a given key if it exists in this partition, but only allows writes if this partition contains all owners of a segment.
ALLOW_READ_WRITES Allow entries on each partition to diverge, with conflicts resolved during merge.
ALLOW_READ_WRITES The type of actions that are possible when a split brain scenario is encountered.
merge-policy PREFERRED_ALWAYS The entry merge policy which should be applied on partition merges.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

distributed-cache

Defines a DIST_* mode cache.

Name Type Default Description
owners int 2 Number of cluster-wide replicas for each cache entry.
segments int 256 Number of hash space segments (per cluster). The default value is 256, and should be at least 20 * cluster size.
l1-lifespan long Maximum lifespan in milliseconds of an entry placed in the L1 cache. By default L1 is disabled unless a positive value is configured for this attribute. If the attribute is not present, L1 is disabled.
l1-cleanup-interval long 60000 Controls how often a cleanup task to prune L1 tracking data is run. Defaults to 10 minutes.
consistent-hash-factory string The factory to use for generating the consistent hash. Must implement `org.infinispan.distribution.ch.ConsistentHashFactory`. E.g. `org.infinispan.distribution.ch.impl.SyncConsistentHashFactory` can be used to guarantee that multiple distributed caches use exactly the same consistent hash, which for performance reasons is not guaranteed by the default consistent hash factory instance used.
key-partitioner string The name of the key partitioner class. Must implement `org.infinispan.distribution.ch.KeyPartitioner`. A custom key partitioner can be used as an alternative to grouping, to guarantee that some keys are located in the same segment (and thus their primary owner is the same node). Since 8.2.

state-transfer?

The state transfer configuration for distribution and replicated caches.

Name Type Default Description
enabled boolean true If enabled, this will cause the cache to ask neighboring caches for state when it starts up, so the cache starts 'warm', although it will impact startup time.
timeout long 240000 The maximum amount of time (ms) to wait for state from neighboring caches, before throwing an exception and aborting startup.
chunk-size integer 512 The number of cache entries to batch in each transfer.
await-initial-transfer boolean true If enabled, this will cause the cache to wait for initial state transfer to complete before responding to requests.

groups?

Configures grouping of data.

Name Type Default Description
enabled boolean Enables or disables grouping.

grouper*

Name Type Default Description
class string The class to use to group keys. Must implement org.infinispan.distribution.group.Grouper.
Name Type Default Description
mode
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
remote-timeout long 15000 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.

partition-handling?

Configures the way this cache reacts to node crashes and split brains.

Name Type Default Description
enabled boolean Deprecated, use type instead. Enable/disable the partition handling functionality. Defaults to false.
when-split
DENY_READ_WRITES If the partition does not have all owners for a given segment, both reads and writes are denied for all keys in that segment.
ALLOW_READS Allows reads for a given key if it exists in this partition, but only allows writes if this partition contains all owners of a segment.
ALLOW_READ_WRITES Allow entries on each partition to diverge, with conflicts resolved during merge.
ALLOW_READ_WRITES The type of actions that are possible when a split brain scenario is encountered.
merge-policy PREFERRED_ALWAYS The entry merge policy which should be applied on partition merges.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.

distributed-cache-configuration

Defines a DIST_* mode cache configuration.

Name Type Default Description
owners int 2 Number of cluster-wide replicas for each cache entry.
segments int 256 Number of hash space segments (per cluster). The default value is 256, and should be at least 20 * cluster size.
l1-lifespan long Maximum lifespan in milliseconds of an entry placed in the L1 cache. By default L1 is disabled unless a positive value is configured for this attribute. If the attribute is not present, L1 is disabled.
l1-cleanup-interval long 60000 Controls how often a cleanup task to prune L1 tracking data is run. Defaults to 10 minutes.
consistent-hash-factory string The factory to use for generating the consistent hash. Must implement `org.infinispan.distribution.ch.ConsistentHashFactory`. E.g. `org.infinispan.distribution.ch.impl.SyncConsistentHashFactory` can be used to guarantee that multiple distributed caches use exactly the same consistent hash, which for performance reasons is not guaranteed by the default consistent hash factory instance used.
key-partitioner string The name of the key partitioner class. Must implement `org.infinispan.distribution.ch.KeyPartitioner`. A custom key partitioner can be used as an alternative to grouping, to guarantee that some keys are located in the same segment (and thus their primary owner is the same node). Since 8.2.

state-transfer?

The state transfer configuration for distribution and replicated caches.

Name Type Default Description
enabled boolean true If enabled, this will cause the cache to ask neighboring caches for state when it starts up, so the cache starts 'warm', although it will impact startup time.
timeout long 240000 The maximum amount of time (ms) to wait for state from neighboring caches, before throwing an exception and aborting startup.
chunk-size integer 512 The number of cache entries to batch in each transfer.
await-initial-transfer boolean true If enabled, this will cause the cache to wait for initial state transfer to complete before responding to requests.

groups?

Configures grouping of data.

Name Type Default Description
enabled boolean Enables or disables grouping.

grouper*

Name Type Default Description
class string The class to use to group keys. Must implement org.infinispan.distribution.group.Grouper.
Name Type Default Description
mode
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
SYNC Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
remote-timeout long 15000 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.

partition-handling?

Configures the way this cache reacts to node crashes and split brains.

Name Type Default Description
enabled boolean Deprecated, use type instead. Enable/disable the partition handling functionality. Defaults to false.
when-split
DENY_READ_WRITES If the partition does not have all owners for a given segment, both reads and writes are denied for all keys in that segment.
ALLOW_READS Allows reads for a given key if it exists in this partition, but only allows writes if this partition contains all owners of a segment.
ALLOW_READ_WRITES Allow entries on each partition to diverge, with conflicts resolved during merge.
ALLOW_READ_WRITES The type of actions that are possible when a split brain scenario is encountered.
merge-policy PREFERRED_ALWAYS The entry merge policy which should be applied on partition merges.
Name Type Default Description
name ID Uniquely identifies this cache within its cache container.
configuration IDREF The name of the cache configuration which this configuration inherits from.
start FIXME Unused XML attribute
jndi-name string Unused XML attribute
module string Unused XML attribute
statistics boolean true Determines whether or not the cache should collect statistics. Keep disabled for optimal performance.
statistics-available boolean true If set to false, statistics gathering cannot be enabled during runtime. Keep disabled for optimal performance.
deadlock-detection-spin long 100 Time period that determines how often is lock acquisition attempted within maximum time allowed to acquire a particular lock. Defaults to 100ms.
unreliable-return-values boolean false Specifies whether Infinispan is allowed to disregard the Map contract when providing return values for org.infinispan.Cache#put(Object, Object) and org.infinispan.Cache#remove(Object) methods.

backups?

The state transfer configuration for distribution and replicated caches.

backup*

Configures a specific site where this cache backups data.

Name Type Default Description
site string Name of the remote site where this cache backups data.
strategy
ASYNC Enables asynchronous mode.
SYNC Enables synchronous mode.
ASYNC The strategy used for backing up data: "SYNC" or "ASYNC". Defaults to "ASYNC"
failure-policy
IGNORE Ignore backup failures.
WARN Warn of backup failures.
FAIL Fail local operations when a backup failure occurs.
CUSTOM Invoke a user-specified failure policy (set via the failure-policy-class attribute)
WARN Decides what the system would do in case of failure during backup. Defaults to "WARN"
timeout long 10000 The timeout(millis) to be used when backing up data remotely. Defaults to 10 secs.
enabled boolean true If 'false' then no data is backed up to this site. Defaults to 'true'.
two-phase-commit boolean false Configures whether the replication happens in a 1PC or 2PC when using SYNC backup strategy. Defaults to "false". CacheConfigurationException is thrown when used with ASYNC backup strategy.
failure-policy-class string If the 'backupFailurePolicy' is set to 'CUSTOM' then this attribute is required and should contain the fully qualified name of a class implementing org.infinispan.xsite.CustomFailurePolicy.

take-offline?

Determines whether this backup is taken offline (ignored) after a certain number of tries.

Name Type Default Description
after-failures int 0 The number of failed request operations after which this site should be taken offline. Defaults to 0 (never). A negative value would mean that the site will be taken offline after 'min-wait'.
min-wait long 0 The minimal number of millis to wait before taking this site offline, even in the case 'after-failures' is reached. If smaller or equal to 0, then only 'after-failures' is considered.

state-transfer?

Configures the properties needed to transfer the state for this site.

Name Type Default Description
chunk-size int 512 If > 0, the state will be transferred in batches of {@code chunkSize} cache entries. If <= 0, the state will be transferred in all at once. Not recommended. Defaults to 512.
timeout long 1200000 The time (in milliseconds) to wait for the backup site acknowledge the state chunk received and applied. Default value is 20 min.
max-retries int 30 The maximum number of retries when a push state command fails. A value <= 0 (zero) mean that the command will not retry. Default value is 30.
wait-time long 2000 The waiting time (in milliseconds) between each retry. The value should be > 0 (zero). Default value is 2 seconds.

backup-for?

Configures this cache as a backup for a remote cache.

Name Type Default Description
remote-cache string The name of the remote cache that backups data here.
remote-site string The name of the remote site containing the cache that backups data here.

encoding?

The cache encoding configuration.

Defines content type and encoding for keys and values of the cache.

key

Describes the content-type and encoding.
Name Type Default Description
media-type string

value

Describes the content-type and encoding.
Name Type Default Description
media-type string

locking?

The locking configuration of the cache.

Name Type Default Description
isolation
NONE No locking isolation will be performed. This is only valid in local mode. In clustered mode, READ_COMMITTED will be used instead.
READ_UNCOMMITTED Unsupported. Actually configures READ_COMMITTED
READ_COMMITTED Read committed is an isolation level that guarantees that any data read is committed at the moment it is read. However, depending on the outcome of other transactions, successive reads may return different results
REPEATABLE_READ Repeatable read is an isolation level that guarantees that any data read is committed at the moment it is read and that, within a transaction, successive reads will always return the same data.
SERIALIZABLE Unsupported. Actually configures REPEATABLE_READ
READ_COMMITTED Sets the cache locking isolation level. Infinispan only supports READ_COMMITTED or REPEATABLE_READ isolation level.
striping boolean false If true, a pool of shared locks is maintained for all entries that need to be locked. Otherwise, a lock is created per entry in the cache. Lock striping helps control memory footprint but may reduce concurrency in the system.
acquire-timeout long 10000 Maximum time to attempt a particular lock acquisition.
concurrency-level int 32 Concurrency level for lock containers. Adjust this value according to the number of concurrent threads interacting with Infinispan.
write-skew boolean false This setting is only applicable in the case of REPEATABLE_READ. When write skew check is set to false, if the writer at commit time discovers that the working entry and the underlying entry have different versions, the working entry will overwrite the underlying entry. If true, such version conflict - known as a write-skew - will throw an Exception. Defaults to false.

transaction?

The cache transaction configuration.

Name Type Default Description
mode
NONE Cache will not enlist within transactions.
BATCH Uses batching to group cache operations together.
NON_XA Cache will enlist within transactions as a javax.transaction.Synchronization
NON_DURABLE_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, without recovery.
FULL_XA Cache will enlist within transactions as a javax.transaction.xa.XAResource, with recovery.
NONE Sets the cache transaction mode to one of NONE, BATCH, NON_XA, NON_DURABLE_XA, FULL_XA.
stop-timeout long 30000 If there are any ongoing transactions when a cache is stopped, Infinispan waits for ongoing remote and local transactions to finish. The amount of time to wait for is defined by the cache stop timeout.
locking
OPTIMISTIC Enables Optimistic locking.
PESSIMISTIC Enables Pessimistic locking.
OPTIMISTIC The locking mode for this cache, one of OPTIMISTIC or PESSIMISTIC.
transaction-manager-lookup string org.infinispan.transaction.lookup.GenericTransactionManagerLookup.GenericTransactionManagerLookup Configure Transaction manager lookup directly using an instance of TransactionManagerLookup. Calling this method marks the cache as transactional.
complete-timeout long 60000 The duration (millis) in which to keep information about the completion of a transaction. Defaults to 60000.
reaper-interval long 30000 The time interval (millis) at which the thread that cleans up transaction completion information kicks in. Defaults to 30000.
auto-commit boolean true If the cache is transactional and transactionAutoCommit is enabled then for single operation transactions the user doesn't need to manually start a transaction, but a transactions is injected by the system. Defaults to true.
protocol
DEFAULT
TOTAL_ORDER
Configures the commit protocol to use.
recovery-cache string __recoveryInfoCacheName__ Sets the name of the cache where recovery related information is held. The cache's default name is "__recoveryInfoCacheName__"
notifications boolean true Enables or disables triggering transactional notifications on cache listeners. By default is enabled.

eviction?

The cache eviction configuration.

DEPRECATED: please use memory element instead
Name Type Default Description
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
NONE Sets the cache eviction strategy. Available options are 'UNORDERED', 'FIFO', 'LRU', 'LIRS' and 'NONE' (to disable eviction).
max-entries long -1 Deprecated since 8.1. Use the size attribute instead.
thread-policy
PIGGYBACK Fires the eviction events from the same thread which is performing the eviction
DEFAULT Use the default eviction listener thread policy (PIGGYBACK)
DEFAULT Threading policy for eviction. Defaults to using the DEFAULT eviction policy.
type
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
COUNT Specifies whether to use entry count or memory-based approximation to decide when to evict entries.
size long -1 Maximum size to use for eviction. When using the COUNT type, this is the maximum number of entries in a cache instance. When using the MEMORY threshold policy, this is the maximum number of allocated bytes used by a cache's datacontainer. A value of -1 means no limit. This is currently limited to 2^48 - 1 in size.

expiration?

The cache expiration configuration.

Name Type Default Description
max-idle long -1 Maximum idle time a cache entry will be maintained in the cache, in milliseconds. If the idle time is exceeded, the entry will be expired cluster-wide. -1 means the entries never expire.
lifespan long -1 Maximum lifespan of a cache entry, after which the entry is expired cluster-wide, in milliseconds. -1 means the entries never expire.
interval long 60000 Interval (in milliseconds) between subsequent runs to purge expired entries from memory and any cache stores. If you wish to disable the periodic eviction process altogether, set interval to -1.

compatibility?

The cache compatibility mode configuration.

Name Type Default Description
marshaller string A marshaller to use for compatibility conversions.

store-as-binary?

Configures the cache to store data in binary format.

Controls whether when stored in memory, keys and values are stored as references to their original objects, or in a serialized, binary format. There are benefits to both approaches, but often if used in a clustered mode, storing objects as binary means that the cost of serialization happens early on, and can be amortized. Further, deserialization costs are incurred lazily which improves throughput. It is possible to control this on a fine-grained basis: you can choose to just store keys or values as binary, or both. DEPRECATED: please use memory element instead
Name Type Default Description
keys boolean true Specify whether keys are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.
values boolean true Specify whether values are stored as binary or not. Enabled by default if the "enabled" attribute is set to true.

persistence?

Configures the cache's persistence layer.

Name Type Default Description
passivation boolean false If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. This gives you the ability to 'overflow' to disk, similar to swapping in an operating system. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. Defaults to false.

versioning?

Controls whether entries are versioned. Versioning is necessary, for example, when using optimistic transactions in a clustered environment, to be able to perform write-skew checks.

Name Type Default Description
scheme
SIMPLE A simple versioning scheme that is cluster-aware
NONE Don't version entries
NONE The scheme to use when versioning entries. Can be either SIMPLE or NONE. Defaults to NONE

data-container?

Controls the data container for the cache.

Name Type Default Description
class string DEPRECATED: this is to be removed in a future release Fully qualified class name of the data container to use
key-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for keys stored in the cache, which provides with custom ways to compare cached keys
value-equivalence string DEPRECATED: this is to be removed in a future release Fully qualified class name of the Equivalence class to use for values stored in the cache, which provides with custom ways to compare cached values

property*

Properties passed to the data container

memory?

Controls how the entries are stored in memory

object

Store keys and values as instance variables. Instances of byte[] will be wrapped to ensure equality.

Name Type Default Description
size long -1 The size of the eviction cache as a long. Limits the cache to this normal by the amount of entries in the cache.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.

binary

Store keys and values as byte[] instances. Key and value will be serialized to binary representations.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use

off-heap

Store keys and values as byte[] off of the Java heap. Key and value will be serialized to binary representations and stored in native memory as to not take up Java heap. Temporary objects will be put onto Java heap temporarily until processing is completed.

Name Type Default Description
size long -1 The size of the eviction cache as a long. If the configured type is COUNT, this will be how many entries can be stored. If the configured type is MEMORY, this will be how much memory in bytes can be stored.
strategy
NONE Never evict entries. This is the default.
UNORDERED Actually activates LRU.
FIFO Deprecated. Actually activates LRU.
LRU Least-Recently Used policy.
LIRS Low Inter-reference Recency Set. An improved version of LRU which uses cache-locality access information to better decide which data to evict.
MANUAL Eviction will be performed manually. Equivalent internally to NONE.
REMOVE Eviction will be performed automatically to ensure that "older" entries are removed to make room for new entries.
EXCEPTION Eviction is not performed and instead when the container is full exceptions will prevent new entries from being written to the container. This cache must be transactional and now allow for commit optimizations that would prevent it from performing a two phase commit.
The eviction strategy to use. This determines if eviction is even enabled or if it has a different variant.
eviction
COUNT Evicts entries from the cache when a specified count has been set
MEMORY Evicts entries from the cache when a specified memory usage has been reached. Memory usage is computed using an approximation which is tailored for the HotSpot VM. This can only be used when both key and values are stored as byte arrays. To guarantee only byte arrays are stored it is recommended to run with store as binary for both keys and values
The eviction type to use whether it is COUNT or MEMORY. COUNT will limit the cache based on the number of entries. MEMORY will limit the cache by how much memory the entries use
address-count int 1048576 How many address pointers to use. This number will be rounded up to a power of two. For optimal performance you will want more address pointers than you expect to have entries. This is similar to the size of an array backing a hash map. Without collisions lookups and writes will be constant time. Each pointer will take up 8 bytes of memory thus the default will use 8 MB of off-heap memory.

modules?

This element contains configuration options for additional modules which affect cache configuration

indexing?

Defines indexing options for cache

Name Type Default Description
index
NONE Do not index data. This is the default.
LOCAL Only index changes made locally, ignoring remote changes. This is useful if indexes are shared across a cluster to prevent redundant indexing of updates.
ALL Index all data
NONE The indexing mode of the cache. Defaults to NONE.
auto-config boolean false Whether or not to apply automatic index configuration based on cache type

indexed-entities?

Defines the indexed entity classes

indexed-entity*

Indexed entity class name

property*

Property to pass on to the indexing system

custom-interceptors?

Configures custom interceptors to be added to the cache.

interceptor*

Name Type Default Description
after string Dictates that the custom interceptor appears immediately after the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
before string Dictates that the custom interceptor appears immediately before the specified interceptor. If the specified interceptor is not found in the interceptor chain, a ConfigurationException will be thrown when the cache starts.
class string A fully qualified class name of the new custom interceptor to add to the configuration.
index int Specifies a position in the interceptor chain to place the new interceptor. The index starts at 0 and goes up to the number of interceptors in a given configuration. A ConfigurationException is thrown if the index is less than 0 or greater than the maximum number of interceptors in the chain.
position string Specifies a position where to place the new interceptor. Allowed values are FIRST, LAST, and OTHER_THAN_FIRST_OR_LAST

property?

security?

Configures cache-level security.

authorization?

Configures authorization for this cache.

Name Type Default Description
enabled boolean true Enables authorization checks for this cache. Defaults to true if the authorization element is present.
roles Sets the valid roles required to access this cache.
Expand/Collapse All