L Command Line 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 already have these Command Line Setting Overrides defined. You can create your own or change the predefined ones.

This feature is useful when you need 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 and/or port 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, prepended with "-D".

L.1 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 the IP address of the interface we want Coherence to use (for instance, 192.168.0.301). We would like to call this override tangosol.coherence.localhost.

First, add a system-property to the cluster-config, unicast-listener, or address element:

<address>localhost</address>

which will look as follows with the property we added:

<address system-property="tangosol.coherence.localhost">localhost</address>

Then use it by modifying the Java command line:

java -jar coherence.jar

Specify the IP address, 192.168.0.301 (instead of the default localhost specified in the configuration) as follows:

java -Dtangosol.coherence.localhost=192.168.0.301 -jar coherence.jar

L.2 Preconfigured Override Values

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

Table L-1 Preconfigured System Property Override Values

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