D System Property Overrides

This appendix describes the system property override feature and lists many of the predefined system properties that are used to change the default settings in Coherence.

This appendix contains the following sections:

Overview of System Property Overrides
Override Example
Preconfigured Override Values

D.1 Overview of System Property Overrides

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".

D.2 Override Example

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

D.3 Preconfigured Override Values

Table D-1 lists all of the preconfigured override values:

Table D-1 Preconfigured System Property Override Values

Override Option	Setting
`coherence.cacheconfig`	Cache configuration descriptor filename. See configurable-cache-factory-config.
`coherence.cluster`	Cluster name. See member-identity.
`coherence.clusteraddress`	Cluster (multicast) IP address. See `<address>` subelement of multicast-listener.
`coherence.clusterport`	Cluster (multicast) IP port. See `<port>` subelement of multicast-listener.
`coherence.distributed.backup`	Data backup storage location. See `backup-storage/type` subelement in DistributedCache Service Parameters.
`coherence.distributed.backupcount`	Number of data backups. See `backup-count` subelement in DistributedCache Service Parameters.
`coherence.distributed.localstorage`	Local partition management enabled. See local-storage subelement in DistributedCache Service Parameters.
`coherence.distributed.threads`	Thread pool size. See `thread-count` subelement in DistributedCache Service Parameters.
`coherence.distributed.transfer`	Partition transfer threshold. See `transfer-threshold` subelement inDistributedCache Service Parameters.
`coherence.edition`	Product edition. See license-config.
`coherence.invocation.threads`	Invocation service thread pool size. See `thread-count` subelement in Invocation Service Parameters.
`coherence.localhost`	Unicast IP address. See `<address>` subelement in unicast-listener.
`coherence.localport`	Unicast IP port. See `<port>` subelement in unicast-listener.
`coherence.localport.adjust`	Unicast IP port auto assignment. See `<port-auto-adjust>` subelement in unicast-listener.
`coherence.log`	Logging destination. See `<logging-config-destination>` subelement in logging-config.
`coherence.log.level`	Logging level. See `<logging-config-level>` subelement in logging-config.
`coherence.log.limit`	Log output character limit. See `<logging-config-limit>` subelement in logging-config.
`coherence.machine`	The computer's name as defined by the `machine-name` element. See member-identity.
`coherence.management`	JMX management mode. See management-config.
`coherence.management.readonly`	JMX management read-only flag. management-config.
`coherence.management.remote`	Remote JMX management enabled flag. See management-config.
`coherence.member`	Member name. See member-identity.
`coherence.mode`	Operational mode. See license-config.
`coherence.override`	Deployment configuration override filename.
`coherence.priority`	Priority. See member-identity.
`coherence.process`	Process name member-identity.
`coherence.proxy.threads`	Coherence*Extend service thread pool size. See `thread-count` subelement in Proxy Service Parameters.
`coherence.rack`	Rack name. See member-identity.
`coherence.role`	Role name. See member-identity.
`coherence.security`	Cache access security enabled flag. See security-config.
`coherence.security.keystore`	Security access controller keystore file name. See security-config.
`coherence.security.permissions`	Security access controller permissions file name. See security-config.
`coherence.shutdownhook`	Shutdown listener action. See shutdown-listener.
`coherence.site`	Site name. See member-identity.
`coherence.tcmp.enabled`	TCMP enabled flag. See `<packet-publisher-enabled>` subelement in packet-publisher.
`coherence.ttl`	Multicast packet time to live (TTL). See `<mulitcast-listener-ttl>` subelement in multicast-listener.
`coherence.wka`	Well known IP address. See well-known-addresses.