D System Property Overrides
This appendix contains the following sections:
- Overview of System Property Overrides
Both the Coherence Operational Configuration and Coherence Cache Configuration deployment descriptors can assign a system property to any element that is defined in the descriptor. - Override Example
Learn how to use the system property override feature by considering an example that overrides the default localhost value. - Preconfigured Override Values
The Coherence system property override reference lists all the preconfigured system properties and the settings they override.
Overview of System Property Overrides
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
".
Parent topic: System Property Overrides
Override Example
localhost
value for an interface.
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 the system property to specify an IP address instead of the default localhost
:
java -Dcoherence.localhost=192.168.0.301 -jar coherence.jar
Parent topic: System Property Overrides
Preconfigured Override Values
tangosol-coherence.xml
file and can be overridden in two
ways:
- By providing your own override file which applies
overrides/specializations to the
tangosol-coherence.xml
file.OR
- For service configuration items (a subset of the reference list in
Table D-1), the relevant XML element in the cache configuration
overrides the service's default value in the
tangosol-coherence.xml
file.
In either case, if the configuration item is specialized, the system-property XML attribute must be present at the point of override to ensure that any value passed through a JVM system property is applied.
The default to determine if a distributed-scheme is storage-enabled is defined in the
tangosol-coherence.xml
file, as seen in the example below:
<service id="3">
<service-type>DistributedCache</service-type>
<service-component>PartitionedService.PartitionedCache</service-component>
...
<init-params>
...
<init-param id="4">
<param-name>local-storage</param-name>
<param-value system-property="coherence.distributed.localstorage">true</param-value>
</init-param>
tangosol-coherence.xml
file, you should redefine it as shown
below:<distributed-scheme>
...
<local-storage system-property="coherence.distributed.localstorage">false</local-storage>
...
</distributed-scheme>
Table D-1 Preconfigured System Property Override Values
System Property | Setting |
---|---|
|
Cache configuration descriptor file name. 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. |
coherence.federation.trace.logging |
Controls the enabling or disabling of federation trace
logging. The default value is |
|
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. |
|
See < |
|
Shutdown listener action. See shutdown-listener. |
|
Time duration string such as "2s" for 2 seconds, "5m" for 5 minutes, or "1h" for 1hour. Default is 2 minutes. |
|
Site name. See member-identity. |
|
TCMP enabled flag. See |
|
Multicast packet time to live (TTL). See |
|
Well known IP address. See well-known-addresses. |
Parent topic: System Property Overrides