JBoss EAP 6.2 Model Reference

  1. JBoss EAP 6.2
  2. subsystem=infinispan
  3. cache-container
  4. distributed-cache

A distributed cache

Children (11)

  • 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 (15)

  • 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.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • 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).
    • Attribute Value
    Default Value LAZY
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values EAGER
    LAZY
  • virtual-nodes Deprecated. Has no effect.
    • Deprecated Since 1.4.0
    Deprecated. Has no effect.
    Attribute Value
    Default Value 1
    Type INT
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services

Operations (2)

  • add Add a distributed cache to this cache container
    Request Parameter Type Required Expressions Allowed Default value Description
    module STRING false true The module whose class loader should be used when building this cache's configuration.
    virtual-nodes INT false false 1 Deprecated. Has no effect.
    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.
    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.
    mode STRING true true Sets the clustered cache mode, ASYNC for asynchronous operation, or SYNC for synchronous operation.
    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.
    batching BOOLEAN false true false If enabled, the invocation batching API will be made available for this cache.
    start STRING false true LAZY The cache start mode, which can be EAGER (immediate start) or LAZY (on-demand start).
    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.
    jndi-name STRING false true The jndi-name to which to bind this cache instance.
    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.
    indexing-properties OBJECT false true Properties to control indexing behaviour
    async-marshalling BOOLEAN false true false If enabled, this will cause marshalling of entries to be performed asynchronously.
    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.
    owners INT false true 2 Number of cluster-wide replicas for each cache entry.
  • remove Remove a distributed cache from this cache container