Admin Distributed System Properties

You can specify the following admin distributed system-specific properties as a list of prop=value pairs on the agent command line or in the JMX Agent’s properties file. The SSL properties listed here affect communication between members of the distributed system.

For more information on configuring SSL for use within GemFire, see SSL. Note that the values of the ssl-* properties in gemfire.properties will likely be identical with the configuration values that you set in agent.properties for the JMX agent.

To configure the JMX agent for SSL communications outside of vFabric GemFire, see Configuring SSL for JMX Agent External Communications.

Argument Comments Default Value

mcast-address

The multicast address of this distributed system. To use IP multicast, you must also define mcast-port, the IP port.

239.192.81.1

mcast-port

The multicast port, a value in the range 0..65535. To use IP multicast, you must also define mcast-address, the IP address.

10334

membership-port-range

The range of ports available for unicast UDP messaging and for TCP failure detection. This is specified as two integers separated by a minus sign. Different members can use different ranges. GemFire randomly chooses two unique integers from this range for the member, one for UDP unicast messaging and the other for TCP failure detection messaging. Additionally, the system uniquely identifies the member using the combined host IP address and UDP port number. You may want to restrict the range of ports that GemFire uses so the product can run in an environment where routers only allow traffic on certain ports.

1024-65535

locators

A comma-delimited list whose elements have the form host[port]. When you use the GemFire locator service, each locator is uniquely identified by the host on which it is running and the port on which it is listening.

""

remote-command

A default remote command prefix to use for command invocation on remote machines.

rsh -n {HOST} {CMD}

ssl-enabled

Indicates whether to use the Secure Sockets Layer (SSL) protocol for communication between members of this distributed system. Valid values are true and false. A true setting requires the use of locators. See SSL for more information on using SSL in GemFire.

false

ssl-protocols

A space-separated list of the valid SSL protocols for this connection. You can specify any to use any protocol that is enabled by default in the configured Java Secure Sockets Extension (JSSE) provider. See SSL for more information on using SSL in GemFire.

any

ssl-ciphers

A space-separated list of the valid SSL ciphers for this connection. You can specify any to use any ciphers that are enabled by default in the configured JSSE provider. See SSL for more information on using SSL in GemFire.

any

ssl-require-authentication

Indicates whether to require authentication for communication between members of the admin distributed system. Valid values are true and false.See SSL for more information on using SSL in GemFire.

true

tcp-port

The TCP port to listen on for cache communications. If set to zero, the operating system selects an available port. Each process on a machine must have its own TCP port. Note that some operating systems restrict the range of ports usable by non-privileged users, and using restricted port numbers can cause runtime errors in GemFire startup. Valid values are in the range 0..65535.

0