Parameters

Used in: init-param.

The following table describes the specific parameter <param-name> - <param-value> pairs that can be configured for various elements.

ReplicatedCache Service Parameters

Description

ReplicatedCache service elements support the following parameters:

These settings may also be specified as part of the replicated-scheme element in the cache configuration descriptor.

Parameters

Parameter Name	Value Description
`standard-lease-milliseconds`	Specifies the duration of the standard lease in milliseconds. Once a lease has aged past this number of milliseconds, the lock will automatically be released. Set this value to zero to specify a lease that never expires. The purpose of this setting is to avoid deadlocks or blocks caused by stuck threads; the value should be set higher than the longest expected lock duration (e.g. higher than a transaction timeout). It's also recommended to set this value higher then `packet-delivery/timeout-milliseconds` value. Legal values are from positive long numbers or zero. Default value is `0`.
`lease-granularity`	Specifies the lease ownership granularity. Available since release 2.3. Legal values are: `thread` `member` A value of `thread` means that locks are held by a thread that obtained them and can only be released by that thread. A value of `member` means that locks are held by a cluster node and any thread running on the cluster node that obtained the lock can release it. Default value is `thread`.
`mobile-issues`	Specifies whether or not the lease issues should be transfered to the most recent lock holders. Legal values are `true` or `false`. Default value is `false`.

DistributedCache Service Parameters

Description

DistributedCache service elements support the following parameters:

These settings may also be specified as part of the distributed-scheme element in the cache configuration descriptor.

Parameters

Parameter Name Value Description

thread-count Specifies the number of daemon threads used by the distributed cache service.

If zero, all relevant tasks are performed on the service thread.

Legal values are from positive integers or zero.

Default value is 0.

Preconfigured override is tangosol.coherence.distributed.threads

standard-lease-milliseconds Specifies the duration of the standard lease in milliseconds. Once a lease has aged past this number of milliseconds, the lock will automatically be released. Set this value to zero to specify a lease that never expires. The purpose of this setting is to avoid deadlocks or blocks caused by stuck threads; the value should be set higher than the longest expected lock duration (e.g. higher than a transaction timeout). It's also recommended to set this value higher then packet-delivery/timeout-milliseconds value.

Legal values are from positive long numbers or zero.

Default value is 0.

lease-granularity

Specifies the lease ownership granularity. Available since release 2.3.

Legal values are:

thread
member

A value of thread means that locks are held by a thread that obtained them and can only be released by that thread. A value of member means that locks are held by a cluster node and any thread running on the cluster node that obtained the lock can release it.

Default value is thread.

transfer-threshold Specifies the threshold for the primary buckets distribution in kilo-bytes. When a new node joins the distributed cache service or when a member of the service leaves, the remaining nodes perform a task of bucket ownership re-destribution. During this process, the existing data gets re-balanced along with the ownership information. This parameter indicates a preferred message size for data transfer communications. Setting this value lower will make the distribution process take longer, but will reduce network bandwith utilization during this activity.

Legal values are integers greater then zero.

Default value is 512 (0.5MB).

partition-count Specifies the number of partitions that a distributed cache will be "chopped up" into. Each member running the distributed cache service that has the local-storage option set to true will manage a "fair" (balanced) number of partitions. The number of partitions should be larger than the square of the number of cluster members to achieve a good balance, and it is suggested that the number be prime. Good defaults include 257 and 1021 and prime numbers in-between, depending on the expected cluster size. A list of first 1,000 primes can be found at http://primes.utm.edu/lists/small/1000.txt

Legal values are prime numbers.

Default value is 257.

local-storage

Specifies whether or not this member of the DistributedCache service enables the local storage.

Normally this value should be left unspecified within the configuration file, and instead set on a per-process basis using the tangosol.coherence.distributed.localstorage system property. This allows cache clients and servers to use the same configuration descriptor.

Legal values are true or false.

Default value is true.

Preconfigured override is tangosol.coherence.distributed.localstorage

backup-count Specifies the number of members of the DistributedCache service that hold the backup data for each unit of storage in the cache.

Value of 0 means that in the case of abnormal termination, some portion of the data in the cache will be lost. Value of N means that if up to N cluster nodes terminate at once, the cache data will be preserved.

To maintain the distributed cache of size M, the total memory usage in the cluster does not depend on the number of cluster nodes and will be in the order of M*(N+1).

Recommended values are 0, 1 or 2.

Default value is 1.

backup-storage/type

Specifies the type of the storage used to hold the backup data.

Legal values are:

on-heap - The corresponding implementations class is java.util.HashMap.
off-heap - The corresponding implementations class is com.tangosol.util.nio.BinaryMap using {com.tangosol.util.nio.DirectBufferManager}}. Only available with JDK 1.4 and later.
file-mapped - The corresponding implementations class is com.tangosol.util.nio.BinaryMap using com.tangosol.util.nio.MappedBufferManager. Only available with JDK 1.4 and later.
custom - The corresponding implementations class is the class specified by the backup-storage/class element.
scheme - The corresponding implementations class is the map returned by the ConfigurableCacheFactory for the scheme referred to by the backup-storage/scheme-name element.

Default value is on-heap.

Preconfigured override is tangosol.coherence.distributed.backup

backup-storage/initial-size

Only applicable with the off-heap and file-mapped types.

Specifies the initial buffer size in bytes.

The value of this element must be in the following format:

[\d]+[[.][\d]]?[K|k|M|m|G|g|T|t]?[B|b]?

where the first non-digit (from left to right) indicates the factor with which the preceeding decimal value should be multiplied:

K or k (kilo, 2¹⁰)
M or m (mega, 2²⁰)
G or g (giga, 2³⁰)
T or t (tera, 2⁴⁰)

If the value does not contain a factor, a factor of mega is assumed.

Legal values are positive integers between 1 and Integer.MAX_VALUE - 1023.

Default value is 1MB.

backup-storage/maximum-size

Only applicable with the off-heap and file-mapped types.

Specifies the maximum buffer size in bytes.

The value of this element must be in the following format:

[\d]+[[.][\d]]?[K|k|M|m|G|g|T|t]?[B|b]?

where the first non-digit (from left to right) indicates the factor with which the preceeding decimal value should be multiplied:

K or k (kilo, 2¹⁰)
M or m (mega, 2²⁰)
G or g (giga, 2³⁰)
T or t (tera, 2⁴⁰)

If the value does not contain a factor, a factor of mega is assumed.

Legal values are positive integers between 1 and Integer.MAX_VALUE - 1023.

Default value is 1024MB.

backup-storage/directory Only applicable with the file-mapped type.

Specifies the pathname for the directory that the disk persistence manager (com.tangosol.util.nio.MappedBufferManager) will use as "root" to store files in. If not specified or specifies a non-existent directory, a temporary file in the default location is used.

Default value is the default temporary directory designated by the Java runtime.

backup-storage/class-name Only applicable with the custom type.

Specifies a class name for the custom storage implementation. If the class implements com.tangosol.run.xml.XmlConfigurable interface then upon construction the setConfig method is called passing the entire backup-storage element.

backup-storage/scheme-name Only applicable with the scheme type.

Specifies a scheme name for the ConfigurableCacheFactory.

key-associator/class-name Specifies the name of a class that implements the com.tangosol.net.partition.KeyAssociator interface. This implementation must have a zero-parameter public constructor.

key-partitioning/class-name Specifies the name of a class that implements the com.tangosol.net.partition.KeyPartitioningStrategy interface. This implementation must have a zero-parameter public constructor.

InvocationService Parameters

Description

InvocationService service elements support the following parameters:

These settings may also be specified as part of the invocation-scheme element in the cache configuration descriptor.

Parameters

Parameter Name	Value Description
`thread-count`	Specifies the number of daemon threads to be used by the invocation service. If zero, all relevant tasks are performed on the service thread. Legal values are from positive integers or zero. Default value is `0`.

Preconfigured override is tangosol.coherence.invocation.threads

Compression Filter Parameters

The compression filter com.tangosol.net.CompressionFilter, supports the following parameters (see java.util.zip.Deflater for details):

Parameters

Parameter Name	Value Description
`buffer-length`	Spesifies compression buffer length in bytes. Legal values are from positive integers or zero. Default value is `0`.
`strategy`	Specifies the compressions strategy. Legal values are: `gzip` `huffman-only` `filtered` `default` Default value is `gzip`.
`level`	Specifies the compression level. Legal values are: `default` `compression` `speed` `none` Default value is `default`.