| | h2.Cache Configuration Deployment Descriptor Elements |
| | |
| | h3.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|Operational Configuration Elements] section. |
| | |
| | h4. Document Location |
| | The name and location of the descriptor is specified in the [operational deployment descriptor|configurable-cache-factory-config] 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. |
| | |
| | h4. Document Root |
| | The root element of the configuration descriptor is {{[cache-config]}}, this is where you may begin configuring your caches. |
| | |
| | h4. Document Format |
| | The Cache Configuration descriptor should begin with the following DOCTYPE declaration: |
| | {code:xml} |
| | <!DOCTYPE cache-config SYSTEM "cache-config.dtd"> |
| | {code}{info:title=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. {info} |
| | |
| | h4. 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. |
| | |
| | | h4. Examples |
| | |
| | See the various [sample|Sample Cache Configurations] cache configurations for usage examples. |
| | |
| | h3. Element Index {anchor:Element Index} |
| | The following table lists all non-terminal elements which may be used from within a cache configuration. |
| | || Element || Used In: || |
| | | {{[acceptor-config]}} | {{[proxy-scheme]}} | |
| | | {{[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]}} | |
| | | {{[cache-service-proxy]}} | {{[proxy-config]}} | |
| | | {{[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-param (cache)]}} | {{[init-params|init-params (cache)]}} | |
| | | {{[init-params|init-params (cache)]}} | {{[class-scheme]}} | |
| | | {{[initiator-config]}} | {{[remote-cache-scheme]}}, {{[remote-invocation-scheme]}} | |
| | | {{[invocation-scheme]}} | {{[caching-schemes]}} | |
| | | {{[jms-acceptor]}} | {{[acceptor-config]}} | |
| | | {{[jms-initiator]}} | {{[initiator-config]}} | |
| | | {{[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]}} | |
| | | {{[outgoing-message-handler|outgoing-message-handler (cache)]}} | {{[acceptor-config]}}, {{[initiator-config]}} | |
| | | {{[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]}} | |
| | | {{[proxy-config]}} | {{[proxy-scheme]}} | |
| | | {{[proxy-scheme]}} | {{[caching-schemes]}} | |
| | | {{[read-write-backing-map-scheme]}} | {{[caching-schemes]}}, {{[distributed-scheme]}}, {{[replicated-scheme]}}, {{[optimistic-scheme]}}| |
| | | {{[remote-cache-scheme]}} | {{[cachestore-scheme]}}, {{[caching-schemes]}}, {{[near-scheme]}} | |
| | | {{[remote-invocation-scheme]}} | {{[caching-schemes]}} | |
| | | {{[replicated-scheme]}} | {{[caching-schemes]}}, {{[near-scheme]}}, {{[versioned-near-scheme]}}, {{[overflow-scheme]}}, {{[versioned-backing-map-scheme]}} | |
| | | {{[tcp-acceptor]}} | {{[acceptor-config]}} | |
| | | {{[tcp-initiator]}} | {{[initiator-config]}} | |
| | | {{[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]}} | |
| | |
| | {pagerating} |