This appendix contains the following sections:
Both the Coherence Operational Configuration deployment descriptor tangosol-coherence.xml
and the Coherence Cache Configuration deployment descriptor coherence-cache-config.xml
can assign a Java command line option name to any element defined in the descriptor. Some elements have predefined overrides. You can create your own or change the predefined ones.
This feature is useful when you want to change the settings for a single JVM, or to be able to start different applications with different settings without making them use different descriptors. The most common application is passing a different multicast address, to allow different applications to create separate clusters.
To create a Command Line Setting Override, add a system-property
attribute, specifying the string you would like to assign as the name for the java command line option to the element you want to create an override to. Then, specify it in the Java command line, prefixed with "-D
".
For example, to create an override for the IP address of the multi-home server to avoid using the default localhost
, and instead specify a specific IP address for the interface (for instance, 192.168.0.301). Call this override coherence.localhost
.
First, add a system-property to the cluster-config
, unicast-listener
, or address
element. For example:
<address system-property="coherence.localhost">localhost</address>
Then use it by modifying the Java command line and specifying an IP address instead of the default localhost
:
java -Dcoherence.localhost=192.168.0.301 -jar coherence.jar
Table D-1 lists all of the preconfigured override values:
Table D-1 Preconfigured System Property Override Values
Override Option | Setting |
---|---|
|
Cache configuration descriptor filename. See "configurable-cache-factory-config". |
|
Cluster name. See "member-identity". |
|
Cluster (multicast) IP address. See |
|
Cluster (multicast) IP port. See |
|
Data backup storage location. See |
|
Number of data backups. See |
|
Local partition management enabled. See local-storage subelement in "DistributedCache Service Parameters". |
|
Thread pool size. See |
|
Partition transfer threshold. See |
|
Product edition. See "license-config". |
|
Invocation service thread pool size. See |
|
Unicast IP address. See |
|
Unicast IP port. See |
|
Unicast IP port auto assignment. See |
|
Logging destination. See |
|
Logging level. See |
|
Log output character limit. See |
|
The computer's name as defined by the |
|
JMX management mode. See "management-config". |
|
JMX management read-only flag. "management-config". |
|
Remote JMX management enabled flag. See"management-config". |
|
Member name. See "member-identity". |
|
Operational mode. See "license-config". |
|
Deployment configuration override filename. |
|
Priority. See "member-identity". |
|
Process name"member-identity". |
|
Coherence*Extend service thread pool size. See |
|
Rack name. See "member-identity". |
|
Role name. See "member-identity". |
|
Cache access security enabled flag. See "security-config". |
|
Security access controller keystore file name. See "security-config". |
|
Security access controller permissions file name. See "security-config". |
|
Shutdown listener action. See "shutdown-listener". |
|
Site name. See "member-identity". |
|
TCMP enabled flag. See |
|
Multicast packet time to live (TTL). See |
|
Well known IP address. See "well-known-addresses". |