Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

10.5.4.5. JdbcStringBasedCacheStore Remote Configuration Attributes

The following is a list of attributes and parameters used to configure a JdbcStringBasedCacheStore in JBoss Data Grid's Remote Client-Server mode.
The cache-container Element

The cache-container element specifies information about the cache container.

  • The name parameter defines the name of the cache container.
  • The default-cache parameter defines the name of the default cache used with the cache container.
  • The listener-executor defines the executor used for asynchronous cache listener notifications.
  • The start parameter indicates where the cache container starts, i.e. whether it will start lazily when requested or when the server starts up. Valid values for this parameter are EAGER and LAZY.
The local-cache Element

The local-cache element specifies information about the local cache used with the cache container.

  • The name parameter specifies the name of the local cache to use.
  • The start parameter indicates where the cache starts, i.e. whether it will start lazily when requested or when the server starts up. Valid values for this parameter are EAGER and LAZY.
  • The batching parameter specifies whether batching is enabled for the local cache.
  • The indexing parameter specifies the type of indexing used for the local cache. Valid values for this parameter are NONE, LOCAL and ALL.
The transport Element

The transport element contains a description of the transport used by the cache container.

  • The stack parameter specified the JGroups stack used for the transport.
  • The executor parameter specifies the executor used for the transport.
  • The lock-timeout parameter specifies the timeout value for locks for the transport.
The replicated-cache Element

The replicated-cache element specifies information about the replicated cache in use.

  • The name parameter specifies the name of the replicated cache.
  • The start parameter specifies whether the cache starts up on demand or immediately. Valid values for this parameter are EAGER and LAZY.
  • The mode parameter specifies the cache mode for the replicated cache. Valid values for this parameter are SYNC and ASYNC.
  • The batching parameter specifies whether batching can be used with the replicated cache.
  • The indexing parameter specifies whether entries added to the cache are indexed. If enabled, indexes update as entries change or are removed from the replicated cache.
  • The remote-timeout parameter specifies the time period a remote call waits for acknowledgment. After the specified interval, the remote call aborts and an exception is thrown. This parameter is used in conjunction with the ASYNC mode parameter.
The locking Element

The locking element details the locking configuration for the local cache.

  • The isolation parameter defines the isolation level used for the local cache. Valid values for this parameter are REPEATABLE_READ and READ_COMMITTED.
  • The acquire-timeout parameter specifies the number of milliseconds after which an acquire operation will time out.
  • The concurrency-level parameter defines the number of lock stripes used by the LockManager.
  • The striping parameter specifies whether lock striping will be used for the local cache.
The transaction Element

The transaction element specifies transaction related settings for the local cache.

  • The mode parameter specifies the transaction mode used for the local cache. Valid values for this parameter are NONE, NON_XA (does not use XAResource), NON_DURABLE_XA (uses XAResource without recovery) and FULL_XA (used XAResource with recovery).
The eviction Element

The eviction element specifies eviction configuration information for the local cache.

  • The strategy parameter specifies the eviction strategy or algorithm used. Valid values for this parameter include NONE, FIFO, LRU, UNORDERED and LIRS.
  • The max-entries parameter specifies the maximum number of entries in a cache instance.
The string-keyed-jdbc-store Element

The string-keyed-jdbc-store element specifies the configuration for a string based keyed cache JDBC store.

  • The datasource parameter defines the name of a JNDI for the datasource.
  • The passivation parameter determines whether entries in the cache are passivated (true) or if the cache store retains a copy of the contents in memory (false).
  • The preload parameter specifies whether to load entries into the cache during start up. Valid values for this parameter are true and false.
  • The purge parameter specifies whether or not the cache store is purged when it is started. Valid values for this parameter are true and false.
  • The shared parameter is used when multiple cache instances share a cache store. This parameter can be set to prevent multiple cache instances writing the same modification multiple times. Valid values for this parameter are ENABLED and DISABLED.
  • The singleton parameter enables a singleton store that is used if a cluster interacts with the underlying store.
The property Element

The property element contains information about properties related to the cache store.

  • The name parameter specifies the name of the cache store.
  • The value ${database.type} must be replaced by a valid database type value, such as DB2_390, SQL_SERVER, MYSQL, ORACLE, POSTGRES or SYBASE.
The string-keyed-table Element

The string-keyed-table element specifies information about the database table used to store string based cache entries.

  • The prefix parameter specifies a prefix string for the database table name.
The id-column Element

The id-column element specifies information about a database column that holds cache entry IDs.

  • The name parameter specifies the name of the database column.
  • The type parameter specifies the type of the database column.
The data-column Element

The data-column element contains information about a database column that holds cache entry data.

  • The name parameter specifies the name of the database column.
  • The type parameter specifies the type of the database column.
The timestamp-column Element

The timestamp-column element specifies information about the database column that holds cache entry timestamps.

  • The name parameter specifies the name of the database column.
  • The type parameter specifies the type of the database column.
Report a bug
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat