Command Line Setting Override Feature

Skip to end of metadata
Go to start of metadata

Both the Coherence Operational Configuration deployment descriptor and the Coherence Cache Configuration deployment descriptor 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 Commmand 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".


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 isntance, We would like to call this override tangosol.coherence.localhost.

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

which will look as follows with the property we added:

Then use it by modifying the Java command line:

java -jar coherence.jar

to specify our address (instead of the default localhost specified in the configuration) as follows:

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

The following table details all the preconfigured overrides:

Override Option Setting
tangosol.coherence.cacheconfig Cache configuration descriptor filename
tangosol.coherence.cluster Cluster name
tangosol.coherence.clusteraddress Cluster (multicast) IP address
tangosol.coherence.clusterport Cluster (multicast) IP port
tangosol.coherence.distributed.backup Data backup storage location
tangosol.coherence.distributed.backupcount Number of data backups
tangosol.coherence.distributed.localstorage Local partition management enabled
tangosol.coherence.distributed.threads Thread pool size
tangosol.coherence.distributed.transfer Partition transfer threshold
tangosol.coherence.edition Product edition
tangosol.coherence.invocation.threads Invocation service thread pool size
tangosol.coherence.localhost Unicast IP address
tangosol.coherence.localport Unicast IP port
tangosol.coherence.localport.adjust Unicast IP port auto assignment
tangosol.coherence.log Logging destination
tangosol.coherence.log.level Logging level
tangosol.coherence.log.limit Log output character limit
tangosol.coherence.machine Machine name JMX management mode JMX management read-only flag Remote JMX management enabled flag
tangosol.coherence.member Member name
tangosol.coherence.mode Operational mode
tangosol.coherence.override Deployment configuration override filename
tangosol.coherence.priority Priority
tangosol.coherence.process Process name
tangosol.coherence.proxy.threads Coherence*Extend service thread pool size
tangosol.coherence.rack Rack name
tangosol.coherence.role Role name Cache access security enabled flag Security access controller keystore file name Keystore or cluster encryption password Security access controller permissions file name
tangosol.coherence.shutdownhook Shutdown listener action Site name
tangosol.coherence.tcmp.enabled TCMP enabled flag
tangosol.coherence.tcpring TCP Ring enabled flag
tangosol.coherence.ttl Multicast packet time to live (TTL)
tangosol.coherence.wka Well known IP address
tangosol.coherence.wka.port Well known IP port
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.