JBoss.org Community Documentation
A list of definitions of each of the XML attributes used above. If the description of an attribute states that it is dynamic , that means it can be changed after the cache is created and started.
Name |
Description |
BuddyReplicationConfig |
An XML element that contains detailed buddy replication configuration. See section on Buddy Replication for details. |
CacheLoaderConfig |
An XML element that contains detailed cache loader configuration. See chapter on Cache Loaders for details. |
CacheLoaderConfiguration |
Deprecated
. Use
|
CacheMode |
LOCAL, REPL_SYNC, REPL_ASYNC, INVALIDATION_SYNC or INVALIDATION_ASYNC. Defaults to LOCAL. See the chapter on Clustering for details. |
ClusterConfig |
The configuration of the underlying JGroups stack.
Ignored if
|
ClusterName |
Name of cluster. Needs to be the same for all nodes in a cluster in order for them to communicate with each other. |
EvictionPolicyConfig |
Configuration parameter for the specified eviction policy. See chapter on eviction policies for details. This property is dynamic . |
ExposeManagementStatistics |
Specifies whether interceptors that provide statistics should have statistics
gathering enabled at startup. Also controls whether a
|
FetchInMemoryState |
Whether or not to acquire the initial in-memory state from
existing members. Allows for hot caches when enabled. Also
see the
|
InactiveOnStartup |
Whether or not the entire tree is inactive upon startup,
only responding to replication messages after
|
StateRetrievalTimeout |
Time in milliseconds to wait for state
retrieval. This should be longer than
|
IsolationLevel |
Node locking isolation level : SERIALIZABLE, REPEATABLE_READ (default), READ_COMMITTED, READ_UNCOMMITTED, and NONE. Note that this is ignored if NodeLockingScheme is OPTIMISTIC. Case doesn't matter. See documentation on Transactions and Concurrency for more details. |
LockAcquisitionTimeout |
Time in milliseconds to wait for a lock to be acquired. If a lock cannot be acquired an exception will be thrown. This property is dynamic . |
LockParentForChildInsertRemove |
Controls whether inserting or removing a node requires a write
lock on the node's parent (when pessimistic locking is used) or whether
it results in an update of the parent node's version (when optimistic
locking is used). The default value is
|
MarshallerClass |
An instance of
|
MultiplexerService |
The JMX object name of the service that defines the JGroups multiplexer.
In JBoss AS 5.0 this service is normally defined in the jgroups-multiplexer.sar.
This XML attribute can only be handled by the JBoss AS MBean deployment services;
if it is included in a file passed to a
|
MultiplexerStack |
The name of the JGroups stack to be used with the cache cluster.
Stacks are defined in the configuration of the external
|
NodeLockingScheme |
May be PESSIMISTIC (default) or OPTIMISTIC. |
ReplicationVersion |
Tells the cache to serialize cluster traffic in a format consistent with that used by the given release of JBoss Cache. Different JBoss Cache versions use different wire formats; setting this attribute tells a cache from a later release to serialize data using the format from an earlier release. This allows caches from different releases to interoperate. For example, a 2.1.0 cache could have this value set to "2.0.0", allowing it to interoperate with a 2.0.0 cache. Valid values are a dot-separated release number, with any final qualifer also separated by a dot, e.g. "2.0.0" or "2.0.0.GA". Values that indicate a 1.x release are not supported in the 2.x series. |
ReplQueueInterval |
Time in milliseconds for elements from the replication
queue to be replicated. Only used if
|
ReplQueueMaxElements |
Max number of elements in the replication queue until
replication kicks in. Only used if
|
SyncCommitPhase |
This option is used to control the behaviour of the commit part of a 2-phase commit protocol,
when
using REPL_SYNC (does not apply to other cache modes). By default this is set to
|
SyncReplTimeout |
For synchronous replication: time in milliseconds to wait
until replication acks have been received from all nodes in the
cluster. It is usually best that this is greater than
|
SyncRollbackPhase |
This option is used to control the behaviour of the rollback part of a 2-phase commit
protocol, when
using REPL_SYNC (does not apply to other cache modes). By default this is set to
|
TransactionManagerLookupClass |
The fully qualified name of a class implementing TransactionManagerLookup. Default is JBossTransactionManagerLookup. There is also an option of GenericTransactionManagerLookup for example. |
UseInterceptorMbeans |
Deprecated
. Use
|
UseRegionBasedMarshalling |
When unmarshalling replicated data, this option specifies whether or not to
support use of different classloaders for different cache regions. This defaults to
|
UseReplQueue |
For asynchronous replication: whether or not to use a
replication queue. Defaults to
|
ShutdownHookBehavior |
An optional parameter that controls whether JBoss Cache registers a shutdown hook with the
JVM
runtime. Allowed values are |
UseLazyDeserialization |
An optional parameter that can be used to enable or disable the use of lazy deserialization
for cached objects. Defaults to |
ObjectInputStreamPoolSize and ObjectOutputStreamPoolSize |
Since JBoss Cache 2.1.0, object input and output streams - used to serialize and deserialize RPC calls in a cluster - are pooled to reduce the overhead of constructing such streams. They are reused by making use of special resettable stream implementations.
by default, these stream pools are set at
|