Cache Configuration Elements

Cache Configuration Deployment Descriptor Elements

Description

The cache configuration deployment descriptor is used to specify the various types of caches which can be used within a cluster. For information on configuring cluster communication, and services see the operational descriptor section.

Document Location

The name and location of the descriptor is specified in the operational deployment descriptor and defaults to coherence-cache-config.xml. The default configuration descriptor (packaged in coherence.jar) will be used unless a custom one is found within the application's classpath. It is recommended that all nodes within a cluster use identical cache configuration descriptors.

Document Root

The root element of the configuration descriptor is cache-config, this is where you may begin configuring your caches.

Document Format

The Cache Configuration descriptor should begin with the following DOCTYPE declaration:

<!DOCTYPE cache-config SYSTEM "cache-config.dtd">
Note:
When deploying Coherence into environments where the default character set is EBCDIC rather than ASCII, please make sure that this descriptor file is in ASCII format and is deployed into its runtime environment in the binary format.

Command Line Override

Tangosol Coherence provides a very powerful Command Line Setting Override Feature, which allows for any element defined in this descriptor to be overridden from the Java command line if it has a system-property attribute defined in the descriptor.

Element Index

The following table lists all non-terminal elements which may be used from within a cache configuration.

Element Used In:
async-store-manager external-scheme, paged-external-scheme
backup-storage distributed-scheme
bdb-store-manager external-scheme, paged-external-scheme, async-store-manager
cache-config root element
cache-mapping caching-scheme-mapping
caching-scheme-mapping cache-config
caching-schemes cache-config
class-scheme caching-schemes, local-scheme, distributed-scheme, replicated-scheme, optimistic-scheme, near-scheme, versioned-near-scheme, overflow-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme, cachestore-scheme, listener
cachestore-scheme local-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme
custom-store-manager external-scheme, paged-external-scheme, async-store-manager
disk-scheme caching-schemes
distributed-scheme caching-schemes, near-scheme, versioned-near-scheme, overflow-scheme, versioned-backing-map-scheme
external-scheme caching-schemes, distributed-scheme, replicated-scheme, optimistic-scheme, near-scheme, versioned-near-scheme, overflow-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme
init-param init-params
init-params class-scheme
invocation-scheme caching-schemes
jms-scheme caching-schemes, cachestore-scheme, near-scheme
key-associator distributed-scheme
key-partitioning distributed-scheme
lh-file-manager external-scheme, paged-external-scheme, async-store-manager
listener local-scheme, disk-scheme, external-scheme, paged-external-scheme, distributed-scheme, replicated-scheme, optimistic-scheme, near-scheme, versioned-near-scheme, overflow-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme
local-scheme caching-schemes, distributed-scheme, replicated-scheme, optimistic-scheme, near-scheme, versioned-near-scheme, overflow-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme
near-scheme caching-schemes
nio-file-manager external-scheme, paged-external-scheme, async-store-manager
nio-memory-manager external-scheme, paged-external-scheme, async-store-manager
optimistic-scheme caching-schemes, near-scheme, versioned-near-scheme, overflow-scheme
overflow-scheme caching-schemes, distributed-scheme, replicated-scheme, optimistic-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme
paged-external-scheme caching-schemes, distributed-scheme, replicated-scheme, optimistic-scheme, near-scheme, versioned-near-scheme, overflow-scheme, read-write-backing-map-scheme, versioned-backing-map-scheme
read-write-backing-map-scheme caching-schemes, distributed-scheme, replicated-scheme, optimistic-scheme
replicated-scheme caching-schemes, near-scheme, versioned-near-scheme, overflow-scheme, versioned-backing-map-scheme
versioned-backing-map-scheme caching-schemes, distributed-scheme, replicated-scheme, optimistic-scheme
versioned-near-scheme caching-schemes
version-transient-scheme versioned-near-scheme, versioned-backing-map-scheme
version-persistent-scheme versioned-backing-map-scheme