Skip Headers
Oracle® Coherence Developer's Guide
Release 3.7

Part Number E18677-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

C 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 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, or port, or both 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".

C.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 IP address for the interface (for instance, 192.168.0.301). Call this override tangosol.coherence.localhost.

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

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

Then use it by modifying the Java command line and specifying an IP address instead of the default localhost:

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

C.2 Preconfigured Override Values

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

Table C-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

The computer's name as defined by the machine-name element. 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. "Using the 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.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".