WildFly 9.0 Model Reference

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

A distributed cache

Children (13)

  • backup A backup site to which to replicate this cache.
  • backup-for A cache for which this cache acts as a backup (for use with cross site replication).
    • BACKUP_FOR A cache for which this cache acts as a backup (for use with cross site replication).
  • binary-keyed-jdbc-store The binary keyed cache JDBC store configuration.
  • eviction The cache eviction configuration.
    • EVICTION The cache eviction configuration.
  • expiration The cache expiration configuration.
  • file-store The cache file store configuration.
  • locking The locking configuration of the cache.
    • LOCKING The locking configuration of the cache.
  • mixed-keyed-jdbc-store The mixed keyed cache JDBC store configuration.
  • remote-store The cache remote store configuration.
  • state-transfer The state transfer configuration for distribution and replicated caches.
    • STATE_TRANSFER The state transfer configuration for distribution and replicated caches.
  • store The cache store configuration.
    • STORE The cache store configuration.
  • string-keyed-jdbc-store The string keyed cache JDBC store configuration.
  • transaction The cache transaction configuration.

Attributes (17)

  • async-marshalling If enabled, this will cause marshalling of entries to be performed asynchronously.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • batching If enabled, the invocation batching API will be made available for this cache.
    • Deprecated Since 3.0.0
    Deprecated. Replaced by BATCH transaction mode.
    Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • capacity-factor Controls the proportion of entries that will reside on the local node, compared to the other nodes in the cluster.
    • Attribute Value
    Default Value 1.0
    Type DOUBLE
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • consistent-hash-strategy Defines the consistent hash strategy for the cache.
    • Attribute Value
    Default Value INTRA_CACHE
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values INTER_CACHE
    INTRA_CACHE
  • indexing If enabled, entries will be indexed when they are added to the cache. Indexes will be updated as entries change or are removed.
    • Attribute Value
    Default Value NONE
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values NONE
    LOCAL
    ALL
  • indexing-properties Properties to control indexing behaviour
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • jndi-name The jndi-name to which to bind this cache instance.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • l1-lifespan Maximum lifespan of an entry placed in the L1 cache. This element configures the L1 cache behavior in 'distributed' caches instances. In any other cache modes, this element is ignored.
    • Attribute Value
    Default Value 600000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • mode Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values SYNC
    ASYNC
  • module The module whose class loader should be used when building this cache's configuration.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • owners Number of cluster-wide replicas for each cache entry.
    • Attribute Value
    Default Value 2
    Type INT
    Nillable true
    Expressions Allowed true
    Min 1
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • queue-flush-interval In ASYNC mode, this attribute controls how often the asynchronous thread used to flush the replication queue runs. This should be a positive integer which represents thread wakeup time in milliseconds.
    • Attribute Value
    Default Value 10
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • queue-size In ASYNC mode, this attribute can be used to trigger flushing of the queue when it reaches a specific threshold.
    • Attribute Value
    Default Value 0
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • remote-timeout In SYNC mode, the timeout (in ms) used to wait for an acknowledgment when making a remote call, after which the call is aborted and an exception is thrown.
    • Attribute Value
    Default Value 17500
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • segments Controls the number of hash space segments which is the granularity for key distribution in the cluster. Value must be strictly positive.
    • Attribute Value
    Default Value 80
    Type INT
    Nillable true
    Expressions Allowed true
    Min 1
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • start The cache start mode, which can be EAGER (immediate start) or LAZY (on-demand start).
    • Deprecated Since 3.0.0
    Deprecated. Future releases will only support LAZY mode.
    Attribute Value
    Default Value LAZY
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values LAZY
  • statistics-enabled If enabled, statistics will be collected for this cache
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services

Operations (2)

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