SystemProps

System properties supported by JGroups (2.4 and higher)

 

The system properties below are recognized by JGroups and override the corresponding values defined in the XML configuration. Note that the new names should be used, as the old names will be phased out in one of the next releases, although they are still supported at the time.

 

Name

Old name

Description

Example

Used in

jgroups.bind_addr

bind.address

The interface to use. If not set, JGroups will pick the first non-loopback NIC. The folloing special values can also be used: GLOBAL (picks a global 'public' IP address), SITE_LOCAL (an address starting with 192.168.x.x. or 10.0.x.x), LINK_LOCAL or NON_LOOPBACK

jgroups.bind_addr=192.168.5.2

UDP, TCP, TCP_NIO, MPING, FD_SOCK, STREAMING_STATE_TRANSFER

jgroups.bind_interface

-

The network interface to use

jgroups.bind_interface=eth0

jgroups.ignore.bind_addr

ignore.bind.address

Overrides the jgroups.bind_addr property (default=false)

jgroups.ignore.bind_addr=true

(same as above)

jgroups.tcpping.initial_hosts

n/a

The initial list of hosts

jgroups.tcpping.initial_hosts=

host1[7800],host2[7800]

TCPPING

jgroups.udp.mcast_addr

jboss.partition.udpGroup

The multicast address

jgroups.udp.mcast_addr=225.1.2.3

UDP

jgroups.udp.mcast_port

jboss.partition.udpPort

The multicast port

jgroups.udp.mcast_port=7500

UDP

jgroups.udp.ip_ttl

n/a

The TTL value

jgroups.udp.ip_ttl=32

UDP

jgroups.mping.mcast_addr

n/a

The multicast address

jgroups.mping.mcast_addr=228.4.5.6

MPING

jgroups.mping.mcast_port

n/a

The multicast port

jgroups.mping.mcast_port=5678

MPING

jgroups.mping.ip_ttl

n/a

The time to live

jgroups.mping.ip_ttl=8

MPING

jgroups.conf.magic_number_file

org.jgroups.conf.magicNumberFile

The location of jg-magic-map.xml

-

-

jgroups.resolve_dns

resolve.dns

Whether of not to resolve a dotted decimal name to a symbolic name (default=false)

-

IpAddress

jgroups.print_uuidsn/aWhether or not to print UUIDs or logical names for addresses (JGroups 2.8)jgroups.print_uuids=true (default: false)TP
jgroups.uuid_cache.max_elementsThe max number of elements in the UUID cache after which we try to evict elements older than max_age millisecondsDefault: 500
jgroups.uuid_cache.max_ageThe max number of milliseconds after which an element can be evicted from the UUID cacheDefault: 5000

jgroups.marshalling.compatible

n/a

Whether of not to use the old style Util.objectFrom/ToByteBuffer()

jgroups.marshalling.compatible=true (default=false)

Util

jgroups.scheduler.max_threads

scheduler.max.threads

The max number of threads in the scheduler

-

jgroups.timer.num_threads

-

The number of threads in the timer service

-

jgroups.use.jdk_logger-If set to true, forces use of the JDK logger even if log4j is on the classpathjgroups.use.jdk_logger=true
jgroups.logging.log_factory_class-The fully qualified classname of a LogFactory implementation; this allows for custom Log creation
jgroups.ipmcast.prefix-Prefix to be used for mapping IPv4 multicast addresses into IPv6 multicast addressesjgroups.ipmcast.prefix="ff0e::"