geode-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From u..@apache.org
Subject [05/17] incubator-geode git commit: GEODE-1377: Refactoring as per review comments
Date Thu, 09 Jun 2016 20:08:31 GMT
GEODE-1377: Refactoring as per review comments


Project: http://git-wip-us.apache.org/repos/asf/incubator-geode/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-geode/commit/ad7fd7e1
Tree: http://git-wip-us.apache.org/repos/asf/incubator-geode/tree/ad7fd7e1
Diff: http://git-wip-us.apache.org/repos/asf/incubator-geode/diff/ad7fd7e1

Branch: refs/heads/develop
Commit: ad7fd7e1807ceae3f13b9684c03b4c19cb9f1f78
Parents: 11e6374
Author: Udo Kohlmeyer <ukohlmeyer@pivotal.io>
Authored: Wed Jun 8 16:45:49 2016 +1000
Committer: Udo Kohlmeyer <ukohlmeyer@pivotal.io>
Committed: Fri Jun 10 05:39:36 2016 +1000

----------------------------------------------------------------------
 .../operations/InterestOperationContext.java    |    4 +-
 .../gemfire/distributed/DistributedSystem.java  | 1389 -----------------
 .../DistributedSystemConfigProperties.java      | 1394 ++++++++++++++----
 .../internal/AbstractDistributionConfig.java    |    2 +
 .../internal/DistributionConfig.java            |   18 +-
 .../internal/DistributionConfigImpl.java        |    2 +
 .../internal/RuntimeDistributionConfigImpl.java |    2 +
 .../gemfire/internal/AbstractConfig.java        |    2 +-
 .../gemfire/internal/logging/LogConfig.java     |    2 +-
 .../internal/security/GeodeSecurityUtil.java    |    2 +-
 .../gms/auth/GMSAuthenticatorJUnitTest.java     |   12 +-
 .../query/dunit/QueryMonitorDUnitTest.java      |  958 +++++-------
 12 files changed, 1499 insertions(+), 2288 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/ad7fd7e1/geode-core/src/main/java/com/gemstone/gemfire/cache/operations/InterestOperationContext.java
----------------------------------------------------------------------
diff --git a/geode-core/src/main/java/com/gemstone/gemfire/cache/operations/InterestOperationContext.java b/geode-core/src/main/java/com/gemstone/gemfire/cache/operations/InterestOperationContext.java
index 18aff9e..2cdd13e 100644
--- a/geode-core/src/main/java/com/gemstone/gemfire/cache/operations/InterestOperationContext.java
+++ b/geode-core/src/main/java/com/gemstone/gemfire/cache/operations/InterestOperationContext.java
@@ -33,7 +33,7 @@ public abstract class InterestOperationContext extends OperationContext {
 
   /**
    * Constructor for the register interest operation.
-   * 
+   *
    * @param key
    *                the key or list of keys being registered/unregistered
    * @param interestType
@@ -73,7 +73,7 @@ public abstract class InterestOperationContext extends OperationContext {
 
   /**
    * Get the <code>InterestType</code> of this register/unregister operation.
-   * 
+   *
    * @return the <code>InterestType</code> of this request.
    */
   public InterestType getInterestType() {

http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/ad7fd7e1/geode-core/src/main/java/com/gemstone/gemfire/distributed/DistributedSystem.java
----------------------------------------------------------------------
diff --git a/geode-core/src/main/java/com/gemstone/gemfire/distributed/DistributedSystem.java b/geode-core/src/main/java/com/gemstone/gemfire/distributed/DistributedSystem.java
index 092131b..12e1837 100755
--- a/geode-core/src/main/java/com/gemstone/gemfire/distributed/DistributedSystem.java
+++ b/geode-core/src/main/java/com/gemstone/gemfire/distributed/DistributedSystem.java
@@ -88,1395 +88,6 @@ import static com.gemstone.gemfire.distributed.DistributedSystemConfigProperties
  * resources and allows your application to connect to a different
  * distributed system, if desirable.
  *
- * <P>
- *
- * <CENTER>
- * <B><a name="configuration">Configuration</a></B>
- * </CENTER>
- *
- * <P>
- *
- * There are a number of configuration properties that can be set when
- * a program {@linkplain #connect connects} to a distributed system.
- *
- * <P>
- *
- * <B>Distribution Configuration Properties</B>
- *
- * <dl>
- *   <a name="groups"><dt>groups</dt></a>
- *   <dd><U>Description</U>: Defines the list of groups this member belongs to.
- *   Use commas to separate group names.
- *   Note that anything defined by the deprecated roles gemfire property will also be considered a group.
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 7.0</dd>
- * </dl>
- * <dl>
- *   <a name="name"><dt>name</dt></a>
- *   <dd><U>Description</U>: Uniquely identifies a member in its distributed system.
- *   If two members with the same name try to join the same distributed system
- *   then the second join will fail.</dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
-
- * <dl>
- *   <a name="distributed-system-id"><dt>distributed-system-id</dt></a>
- *<dd> A number that uniquely identifies this distributed system, when
- * using the WAN gateway to share data between multiple distributed systems. This
- * setting is only required when using the WAN gateway in conjunction with
- * the Portable Data eXchange (PDX) serialization format.
- * 
- * If set, this setting must be the same for every member in this distributed
- * system. It must be different than the number in other distributed systems
- * that this one will connect to using the WAN.
- * 
- * -1 means no setting.</dd>
- * 
- *   <dd><U>Range</U>-1..255</dd>
- *   <dd><U>Default</U>: "-1"</dd>
- * </dl>
- *
- * <dl>
- *   <a name="mcast-port"><dt>mcast-port</dt></a>
- *   <dd><U>Description</U>: The port used for multicast networking.
- *   If zero, then multicast will be disabled and unicast messaging will
- *   be used.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- * </dl>
- *
- * <dl>
- *   <a name="mcast-address"><dt>mcast-address</dt></a>
- *   <dd><U>Description</U>: The IP address used for multicast
- *   networking.  If mcast-port is zero, then mcast-address is
- *   ignored.
- *   </dd>
- *   <dd><U>Default</U>: "239.192.81.1"</dd>
- * </dl>
- * <dl>
- *   <a name="mcast-ttl"><dt>mcast-ttl</dt></a>
- *   <dd><U>Description</U>: Determines how far through your network
- *   the multicast packets used by GemFire will propagate.
- *   <dd><U>Default</U>: "32"</dd>
- *   <dd><U>Allowed values</U>: 0..255</dd>
- *   <dd><U>Since</U>: 4.1</dd>
- * </dl>
- * <dl>
- *   <a name="mcast-send-buffer-size"><dt>mcast-send-buffer-size</dt></a>
- *   <dd><U>Description</U>: Sets the size of the socket buffer used for
- *    outgoing multicast transmissions.
- *   <dd><U>Default</U>: "65535"</dd>
- *   <dd><U>Allowed values</U>: 2048..Operating System maximum</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="mcast-recv-buffer-size"><dt>mcast-recv-buffer-size</dt></a>
- *   <dd><U>Description</U>: Sets the size of the socket buffer used for
- *    incoming multicast transmissions.  You should set this high if there will be
- *    high volumes of messages.
- *   <dd><U>Default</U>: "1048576"</dd>
- *   <dd><U>Allowed values</U>: 2048..Operating System maximum</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="mcast-flow-control"><dt>mcast-flow-control</dt></a>
- *   <dd><U>Description</U>: Configures the flow-of-control protocol for
- *    multicast messaging.  There are three settings that are separated
- *    by commas:  byteAllowance (integer), rechargeThreshold (float) and
- *    rechargeBlockMs (integer).  The byteAllowance determines how many bytes
- *    can be sent without a recharge from other processes.  The rechargeThreshold
- *    tells receivers how low the sender's initial to remaining allowance
- *    ratio should be before sending a recharge.  The rechargeBlockMs
- *    tells the sender how long to wait for a recharge before explicitly
- *    requesting one.</dd>
- *   <dd><U>Deprecated</U>: as of 9.0 GemFire does not include a flow-of-control protocol for multicast messaging.</dd>
- *   <dd><U>Default</U>: "1048576,0.25,5000"</dd>
- *   <dd><U>Allowed values</U>: 100000-maxInt, 0.1-0.5, 500-60000</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- *
- * <dl>
- *   <a name="udp-send-buffer-size"><dt>udp-send-buffer-size</dt></a>
- *   <dd><U>Description</U>: Sets the size of the socket buffer used for
- *    outgoing udp point-to-point transmissions.
- *   <dd><U>Default</U>: "65535"</dd>
- *   <dd><U>Allowed values</U>: 2048..Operating System maximum</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="udp-recv-buffer-size"><dt>udp-recv-buffer-size</dt></a>
- *   <dd><U>Description</U>: Sets the size of the socket buffer used for
- *    incoming udp point-to-point transmissions.  Note: if multicast is not
- *    enabled and disable-tcp is not enabled, a reduced default size of
- *    65535 is used.
- *   <dd><U>Default</U>: "1048576 if multicast is enabled or disable-tcp is true, 131071 if not"</dd>
- *   <dd><U>Allowed values</U>: 2048..Operating System maximum</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="udp-fragment-size"><dt>udp-fragment-size</dt></a>
- *   <dd><U>Description</U>: When messages are sent over datagram sockets,
- *    GemFire breaks large messages down into fragments for transmission.
- *    This property sets the maximum fragment size for transmission.
- *   <dd><U>Default</U>: "60000"</dd>
- *   <dd><U>Allowed values</U>: 1000..60000</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="disable-tcp"><dt>disable-tcp</dt></a>
- *   <dd><U>Description</U>: Turns off use of tcp/ip sockets, forcing the
- *    cache to use datagram sockets for all communication.  This is useful
- *    if you have a large number of processes in the distributed cache since
- *    it eliminates the per-connection reader-thread that is otherwise required.
- *    However, udp communications are somewhat slower than tcp/ip communications
- *    due to the extra work required in Java to break messages down to
- *    transmittable sizes, and the extra work required to guarantee
- *    message delivery.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Allowed values</U>: true or false</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="tcp-port"><dt>tcp-port</dt></a>
- *   <dd><U>Description</U>: A 16-bit integer that determines the tcp/ip port number to listen on
- *     for cache communications.  If zero, the operating system will select
- *     an available port to listen on.  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.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..65535</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="member-timeout"><dt>member-timeout</dt></a>
- *   <dd><U>Description</U>: Sets the timeout interval, in milliseconds, used
- *   to determine whether another process is alive or not.  When another process
- *   appears to be gone, GemFire sends it an ARE-YOU-DEAD message and waits
- *   for the member-timeout period for it to respond and declare it is not dead.
- *   </dd>
- *   <dd><U>Default</U>: "5000"</dd>
- *   <dd><U>Allowed values</U>: 1000-600000</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- * <dl>
- *   <a name="bind-address"><dt>bind-address</dt></a>
- *   <dd><U>Description</U>: The IP address that this distributed system's
- *   server sockets will listen on.
- *   If set to an empty string then the local machine's
- *   default address will be listened on.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * <!--
- * <dl>
- *   <a name="server-bind-address"><dt>server-bind-address</dt></a>
- *   <dd><U>Description</U>: The IP address that this distributed system's
- *   server sockets in a client-server topology will listen on.
- *   If set to an empty string then all of the local machine's
- *   addresses will be listened on.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * -->
- * <dl>
- *   <a name="membership-port-range"><dt>membership-port-range</dt></a>
- *   <dd><U>Description</U>: The allowed range of ports for use in forming an
- *   unique membership identifier (UDP), for failure detection purposes (TCP) and
- *   to listen on for peer connections (TCP). This range is given as two numbers
- *   separated by a minus sign. Minimum 3 values in range are required to
- *   successfully startup.
- *   </dd>
- *   <dd><U>Default</U>: 1024-65535</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="locators"><dt>locators</dt></a>
- *   <dd><U>Description</U>: A list of locators (host and port) that
- *   are used to find other member of the distributed system.  This
- *   attribute's value is a possibly empty comma separated list.  Each
- *   element must be of the form "hostName[portNum]" and may be of the
- *   form "host:bindAddress[port]" if a specific bind address is to be
- *   used on the locator machine.  The square
- *   brackets around the portNum are literal character and must be
- *   specified.<p>
- *   Since IPv6 bind addresses may contain colons, you may use an at symbol
- *   instead of a colon to separate the host name and bind address.
- *   For example, "server1@fdf0:76cf:a0ed:9449::5[12233]" specifies a locator
- *   running on "server1" and bound to fdf0:76cf:a0ed:9449::5 on port 12233.<p>
- *   If "locators" is empty
- *   then this distributed system will be isolated from all other GemFire
- *   processes.<p>
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="locator-wait-time"><dt>locator-wait-time</dt></a>
- *   <dd><U>Description</U>: The number of seconds to wait for a locator to start
- *   if one is not available when attempting to join the distributed system.  This
- *   setting can be used when locators and peers are being started all at once in
- *   order to have the peers be patient and wait for the locators to finish starting
- *   up before attempting to join the distributed system..<p>
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- * 
- * <dl>
- *   <a name="remote-locators"><dt>remote-locators</dt></a>
- *   <dd><U>Description</U>: A list of locators (host and port) that a cluster
- *   will use in order to connect to a remote site in a multi-site (WAN) 
- *   configuration. This attribute's value is a possibly comma separated list.
- *   <p>For each remote locator, provide a hostname and/or address 
- *   (separated by '@', if you use both), followed by a port number in brackets.
- *   <p>Examples:
- *   remote-locators=address1[port1],address2[port2]
- *   <p>
- *   remote-locators=hostName1@address1[port1],hostName2@address2[port2]
- *   <p>
- *   remote-locators=hostName1[port1],hostName2[port2]<p>
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="start-locator"><dt>start-locator</dt></a>
- *   <dd><U>Description</U>: A host name or bind-address and port 
- *   ("host[port],peer=<true|false>,server=<true|false>")
- *   that are used to start a locator in the same process as the DistributedSystem.
- *   The locator is started when the DistributedSystem connects,
- *   and is stopped when the DistributedSystem disconnects.  To start a
- *   locator that is not tied to the DistributedSystem's lifecycle, see
- *   the {@link Locator} class in this same package.<p>
- *   
- *   The peer and server parameters are optional. They specify whether
- *   the locator can be used for peers to discover each other, or for clients
- *   to discover peers. By default both are true.
- *   </dd>
- *   <dd><U>Default</U>: "" (doesn't start a locator)</dd>
- * </dl>
- *
- * <dl>
- *   <a name="ssl-enabled"><dt>ssl-enabled</dt></a>
- *   <dd><U>Description</U>: If true, all gemfire socket communication is
- *   configured to use SSL through JSSE.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Deprecated</U>: as of 8.0 use <a href="#cluster-ssl-enabled"><code>cluster-ssl-enabled</code></a> instead.</dd>
- * </dl>
- *
- * <dl>
- *   <a name="ssl-protocols"><dt>ssl-protocols</dt></a>
- *   <dd><U>Description</U>: A space separated list of the SSL protocols to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: "any"</dd>
- *   <dd><U>Deprecated</U>: as of 8.0 use <a href="#cluster-ssl-protocols"><code>cluster-ssl-protocols</code></a> instead.</dd>
- * </dl>
- *
- * <dl>
- *   <a name="ssl-ciphers"><dt>ssl-ciphers</dt></a>
- *   <dd><U>Description</U>: A space separated list of the SSL cipher suites to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: "any"</dd>
- *   <dd><U>Deprecated</U>: as of 8.0 use <a href="#cluster-ssl-ciphers"><code>cluster-ssl-ciphers</code></a> instead.</dd>
- * </dl>
- *
- * <dl>
- *   <a name="ssl-require-authentication"><dt>ssl-require-authentication</dt></a>
- *   <dd><U>Description</U>: If false, allow ciphers that do not require the client
- *   side of the connection to be authenticated.
- *   </dd>
- *   <dd><U>Default</U>: "true"</dd>
- *   <dd><U>Deprecated</U>: as of 8.0 use <a href="#cluster-ssl-require-authentication"><code>cluster-ssl-require-authentication</code></a> instead.</dd>
- * </dl>
- *
- * <dl>
- *   <a name="cluster-ssl-enabled"><dt>cluster-ssl-enabled</dt></a>
- *   <dd><U>Description</U>: If true, all gemfire socket communication is
- *   configured to use SSL through JSSE. Preferably Use cluster-ssl-* properties
- *   rather than ssl-* properties.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-protocols"><dt>cluster-ssl-protocols</dt></a>
- *   <dd><U>Description</U>: A space separated list of the SSL protocols to
- *   enable. Those listed must be supported by the available providers.Preferably
- *   use cluster-ssl-* properties rather than ssl-* properties.
- *   </dd>
- *   <dd><U>Default</U>: "any"</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-ciphers"><dt>cluster-ssl-ciphers</dt></a>
- *   <dd><U>Description</U>: A space separated list of the SSL cipher suites to
- *   enable. Those listed must be supported by the available providers.Preferably
- *   use cluster-ssl-* properties rather than ssl-* properties.
- *   </dd>
- *   <dd><U>Default</U>: "any"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-require-authentication"><dt>cluster-ssl-require-authentication</dt></a>
- *   <dd><U>Description</U>: If false, allow ciphers that do not require the
- *   client side of the connection to be authenticated.Preferably use
- *   cluster-ssl-* properties rather than ssl-* properties.
- *   </dd>
- *   <dd><U>Default</U>: "true"</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-keystore"><dt>cluster-ssl-keystore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing
- *   certificate and private key.</dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-keystore-type"><dt>cluster-ssl-keystore-type</dt></a>
- *   <dd><U>Description</U>For Java keystore file format, this property has the
- *   value jks (or JKS).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-keystore-password"><dt>cluster-ssl-keystore-password</dt></a>
- *   <dd><U>Description</U>Password to access the private key from the keystore
- *   file specified by javax.net.ssl.keyStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-truststore"><dt>cluster-ssl-truststore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing the
- *   collection of CA certificates trusted by distributed member (trust store).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="cluster-ssl-truststore-password"><dt>cluster-ssl-truststore-password</dt></a>
- *   <dd><U>Description</U>Password to unlock the keystore file (store password)
- *   specified by javax.net.ssl.trustStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="ack-wait-threshold"><dt>ack-wait-threshold</dt></a>
- *   <dd><U>Description</U>: The number of seconds the distributed
- *   system will wait for a message to be acknowledged before it sends
- *   a <i>warning</i> level alert to signal that something might be wrong with the system
- *   node that is unresponsive.  After sending this alert the waiter
- *   continues to wait. The alerts are logged in the log as warnings
- *   and will cause an alert notification in the Admin API and GemFire
- *   JMX Agent.</dd>
- *   <dd><U>Default</U>: "15"</dd>
- *   <dd><U>Allowed values</U>: 1..2147483647</dd>
- * </dl>
- *
- * <dl>
- *   <a name="ack-severe-alert-threshold"><dt>ack-severe-alert-threshold</dt></a>
- *   <dd><U>Description</U>:
- *   The number of seconds the distributed
- *   system will wait after the ack-wait-threshold for a message to be
- *   acknowledged before it issues an alert at <i>severe</i> level.  The
- *   default value is zero, which turns off this feature.<p>
- *   when ack-severe-alert-threshold is used, GemFire will also initiate
- *   additional checks to see if the process is alive.  These checks will
- *   begin when the ack-wait-threshold is reached and will continue until
- *   GemFire has been able to communicate with the process and ascertain its
- *   status.
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..2147483647</dd>
- * </dl>
- *
- * <dl>
- *   <a name="conserve-sockets"><dt>conserve-sockets</dt></a>
- *   <dd><U>Description</U>: If "true" then a minimal number of sockets
- *   will be used when connecting to the distributed system. This conserves
- *   resource usage but can cause performance to suffer.
- *   If "false" then every application thread that sends
- *   distribution messages to other members of the distributed system
- *   will own its own sockets and have exclusive access to them.
- *   The length of time a thread can have exclusive access to a socket
- *   can be configured with "socket-lease-time".
- *   <dd><U>Default</U>: "true"</dd>
- *   <dd><U>Allowed values</U>: true|false</dd>
- *   <dd><U>Since</U>: 4.1</dd>
- * </dl>
- * <dl>
- *   <a name="socket-lease-time"><dt>socket-lease-time</dt></a>
- *   <dd><U>Description</U>: The number of milliseconds a thread
- *   can keep exclusive access to a socket that it is not actively using.
- *   Once a thread loses its lease to a socket it will need to re-acquire
- *   a socket the next time it sends a message.
- *   A value of zero causes socket leases to never expire.
- *   This property is ignored if "conserve-sockets" is true.
- *   <dd><U>Default</U>: "15000"</dd>
- *   <dd><U>Allowed values</U>: 0..600000</dd>
- *   <dd><U>Since</U>: 4.1</dd>
- * </dl>
- * <dl>
- *   <a name="socket-buffer-size"><dt>socket-buffer-size</dt></a>
- *   <dd><U>Description</U>: The size of each socket buffer, in bytes.
- *   Smaller buffers conserve memory. Larger buffers can improve performance;
- *   in particular if large messages are being sent.
- *   <dd><U>Default</U>: "32768"</dd>
- *   <dd><U>Allowed values</U>: 128..16777215</dd>
- *   <dd><U>Since</U>: 4.1</dd>
- * </dl>
- * <dl>
- *   <a name="conflate-events"><dt>conflate-events</dt></a>
- *   <dd><U>Description</U>: This is a client-side property that is passed to
- *   the server. Allowable values are "server", "true", and "false". With the
- *   "server" setting, this client&apos;s servers use their own client queue
- *   conflation settings. With a "true" setting, the servers disregard their
- *   own configuration and enable conflation of events for all regions for the
- *   client. A "false" setting causes the client&apos;s servers to disable
- *   conflation for all regions for the client.
- *   <dd><U>Default</U>: "server"</dd>
- *   <dd><U>Since</U>: 5.7</dd>
- * </dl>
- * <dl>
- *   <a name="durable-client-id"><dt>durable-client-id</dt></a>
- *   <dd><U>Description</U>: The id to be used by this durable client. When a
- *   durable client connects to a server, this id is used by the server to
- *   identify it. The server will accumulate updates for a durable client
- *   while it is disconnected and deliver these events to the client when it
- *   reconnects.
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 5.5</dd>
- * </dl>
- * <dl>
- *   <a name="durable-client-timeout"><dt>durable-client-timeout</dt></a>
- *   <dd><U>Description</U>: The number of seconds a disconnected durable
- *   client is kept alive and updates are accumulated for it by the server
- *   before it is terminated.
- *   <dd><U>Default</U>: "300"</dd>
- *   <dd><U>Since</U>: 5.5</dd>
- * </dl>
- *<dl>
- *   <a name="security-"><dt>security-</dt></a>
- *   <dd><U>Description</U>: Mechanism to define client credentials.
- *   All tags with "security-" prefix is packaged together as security properties 
- *   and passed as an argument to getCredentials of Authentication module.
- *   These tags cannot have null values. 
- *   </dd>
- *   <dd><U>Default</U>: Optional</dd>
- *   <dd><U>Allowed values</U>: any string</dd>
- * </dl>
- * 
- *<dl>
- *   <a name="security-client-auth-init"><dt>security-client-auth-init</dt></a>
- *   <dd><U>Description</U>: Authentication module name for Clients that requires to act
- *   upon credentials read from the gemfire.properties file.
- *   Module must implement AuthInitialize interface.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Allowed values</U>: jar file:class name</dd>
- *</dl>
- * 
- * <dl>
- * <a name="delta-propagation">
- * <dt>delta-propagation</dt>
- * </a>
- * <dd><U>Description</U>: "true" indicates that server propagates delta
- * generated from {@link com.gemstone.gemfire.Delta} type of objects. If "false"
- * then server propagates full object but not delta. </dd>
- * <dd><U>Default</U>: "true"</dd>
- * <dd><U>Allowed values</U>: true|false</dd>
- * </dl> 
- * 
- * <b>Network Partitioning Detection</b>
- * 
- * <dl>
- *   <a name="enable-network-partition-detection"><dt>enable-network-partition-detection</dt></a>
- *   <dd><U>Description</U>: Turns on network partitioning detection algorithms, which
- *   detect loss of quorum and shuts down losing partitions.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="disable-auto-reconnect"><dt>disable-auto-reconnect</dt></a>
- *   <dd><U>Description</U>: By default GemFire will attempt to reconnect and
- *   reinitialize the cache when it has been forced out of the distributed system
- *   by a network-partition event or has otherwise been shunned by other members.
- *   This setting will turn off this behavior.</dd>
- *   <dd><U>Default</U>: "false"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="max-wait-time-reconnect"><dt>max-wait-time-reconnect</dt></a>
- *   <dd><U>Description</U>: Specifies the time in milliseconds to wait before each reconnect attempt when
- *   a member of the distributed system is forced out of the system and auto-reconnect
- *   is enabled (see <a href="#disable-auto-reconnect"><code>disable-auto-reconnect</code></a>) or if the deprecated required-roles
- *   feature is being used and a role-loss has triggered a shutdown and reconnect.
- *   </dd>
- *   <dd><U>Default</U>: "60000"</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- *
- *
- * <b>Redundancy Management</b>
- * 
- * <dl>
- *   <a name="enforce-unique-host"><dt>enforce-unique-host</dt></a>
- *   <dd><U>Description</U>: Whether or not partitioned regions will
- *   put redundant copies of the same data in different JVMs running on the same physical host.
- *   
- *   By default, partitioned regions will try to put redundancy copies on different physical hosts, but it may 
- *   put them on the same physical host if no other hosts are available. Setting this property to true
- *   will prevent partitions regions from ever putting redundant copies of data on the same physical host.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="redundancy-zone"><dt>redundancy-zone</dt></a>
- *   <dd><u>Description</u>: Defines the redundancy zone from this member. If this property is set, partitioned
- *   regions will not put two redundant copies of data in two members with the same redundancy zone setting.   
- *   </dd>
- *   <dd><u>Default</u>: ""</dd>
- * </dl>
- *
- * <B>Logging Configuration Properties</B>
- *
- * <dl>
- *   <a name="log-file"><dt>log-file</dt></a>
- *   <dd><U>Description</U>: Name of the file to write logging
- *   messages to.  If the file name if "" (default) then messages are
- *   written to standard out.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- *
- * <dl>
- *   <a name="log-level"><dt>log-level</dt></a>
- *   <dd><U>Description</U>:The type of log messages that will
- *   actually write to the log file.
- *   </dd>
- *   <dd><U>Default</U>: "config"</dd>
- *   <dd><U>Allowed values</U>: all|finest|finer|fine|config|info|warning|severe|none</dd>
- * </dl>
- *
- * <dl>
- *   <a name="statistic-sampling-enabled"><dt>statistic-sampling-enabled</dt></a>
- *   <dd><U>Description</U>: "true" causes the statistics to be
- *   sampled periodically and operating system statistics to be
- *   fetched each time a sample is taken.  "false" disables sampling
- *   which also disables operating system statistic collection.  Non
- *   OS statistics will still be recorded in memory and can be viewed
- *   by administration tools.  However, charts will show no activity
- *   and no statistics will be archived while sampling is
- *   disabled.
- *   Starting in 7.0 the default value has been changed to true.
- *   If statistic sampling is disabled it will also cause various
- *   metrics seen in gfsh and pulse to always be zero.
- *   </dd>
- *   <dd><U>Default</U>: "true"</dd>
- *   <dd><U>Allowed values</U>: true|false</dd>
- * </dl>
- *
- * <dl>
- *   <a name="statistic-sample-rate"><dt>statistic-sample-rate</dt></a>
- *   <dd><U>Description</U>:The rate, in milliseconds, at which samples
- *   of the statistics will be taken.
- *   If set to a value less than 1000 the rate will be set to 1000 because
- *   the VSD tool does not support sub-second sampling.
- *   </dd>
- *   <dd><U>Default</U>: "1000"</dd>
- *   <dd><U>Allowed values</U>: 100..60000</dd>
- * </dl>
- *
- * <dl>
- *   <a name="statistic-archive-file"><dt>statistic-archive-file</dt></a>
- *   <dd><U>Description</U>: The file that statistic samples are
- *   written to.  An empty string (default) disables statistic
- *   archival.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- *
- * <dl>
- *   <a name="enable-time-statistics"><dt>enable-time-statistics</dt></a>
- *   <dd><U>Description</U>: "true" causes additional time-based statistics to be
- *   gathered for gemfire operations.  This can aid in discovering
- *   where time is going in cache operations, albeit at the expense of
- *   extra clock probes on every operation.  "false" disables the additional
- *   time-based statistics.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Allowed values</U>: true or false</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- *
- * <dl>
- *   <a name="log-file-size-limit"><dt>log-file-size-limit</dt></a>
- *   <dd><U>Description</U>: Limits, in megabytes, how large the current log
- *   file can grow before it is closed and logging rolls on to a new file.
- *   Set to zero to disable log rolling.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..1000000</dd>
- * </dl>
- * <dl>
- *   <a name="log-disk-space-limit"><dt>log-disk-space-limit</dt></a>
- *   <dd><U>Description</U>: Limits, in megabytes, how much disk space can be
- *   consumed by old inactive log files. When the limit is
- *   exceeded the oldest inactive log file is deleted.
- *   Set to zero to disable automatic log file deletion.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..1000000</dd>
- * </dl>
- *
- * <dl>
- *   <a name="archive-file-size-limit"><dt>archive-file-size-limit</dt></a>
- *   <dd><U>Description</U>: Limits, in megabytes, how large the current statistic archive
- *   file can grow before it is closed and archival rolls on to a new file.
- *   Set to zero to disable archive rolling.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..1000000</dd>
- * </dl>
- * <dl>
- *   <a name="archive-disk-space-limit"><dt>archive-disk-space-limit</dt></a>
- *   <dd><U>Description</U>: Limits, in megabytes, how much disk space can be
- *   consumed by old inactive statistic archive files. When the limit is
- *   exceeded the oldest inactive archive is deleted.
- *   Set to zero to disable automatic archive deletion.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..1000000</dd>
- * </dl>
- *
- * <dl>
- *   <a name="roles"><dt>roles</dt></a>
- *   <dd><U>Description</U>: Specifies the application roles that this member
- *   performs in the distributed system. This is a comma delimited list of
- *   user-defined strings. Any number of members can be configured to perform
- *   the same role, and a member can be configured to perform any number of
- *   roles.
- *   Note that anything defined by the groups gemfire property will also be considered a role.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- *   <dd><U>Deprecated</U>: This feature is scheduled to be removed.</dd>
- * </dl>
- *
- * <dl>
- *   <a name="max-wait-time-reconnect"><dt>max-wait-time-reconnect</dt></a>
- *   <dd><U>Description</U>: Specifies the time in milliseconds to wait before each reconnect attempt when
- *   a member of the distributed system is forced out of the system and auto-reconnect
- *   is enabled (see <a href="#disable-auto-reconnect"><code>disable-auto-reconnect</code></a>) or if the deprecated required-roles
- *   feature is being used and a role-loss has triggered a shutdown and reconnect.
- *   </dd>
- *   <dd><U>Default</U>: "60000"</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- *
- * <dl>
- *   <a name="max-num-reconnect-tries"><dt>max-num-reconnect-tries</dt></a>
- *   <dd><U>Description</U>: Specifies the maximum number or times to attempt
- *   to reconnect to the distributed system when required roles are missing.
- *   This does not apply to reconnect attempts due to a forced disconnect.
- *   </dd>
- *   <dd><U>Deprecated</U>: this setting is scheduled to be removed.</dd>
- *   <dd><U>Default</U>: "3"</dd>
- *   <dd><U>Since</U>: 5.0</dd>
- * </dl>
- *
- * <B>Cache Configuration Properties</B>
- *
- * <dl>
- *   <a name="cache-xml-file"><dt>cache-xml-file</dt></a>
- *   <dd><U>Description</U>: Specifies the name of the XML file or resource
- *   to initialize the cache with when it is
- *   {@linkplain com.gemstone.gemfire.cache.CacheFactory#create created}.
- *   Create will first look for a file that matches the value of this property.
- *   If a file is not found then it will be searched for using
- *   {@link java.lang.ClassLoader#getResource}.  If the value of this
- *   property is the empty string (<code>""</code>), then the cache
- *   will not be declaratively initialized.</dd>
- *   <dd><U>Default</U>: "cache.xml"</dd>
- * </dl>
- *
- * <dl>
- *   <a name="memcached-port"><dt>memcached-port</dt></a>
- *   <dd><U>Description</U>: Specifies the port used by {@link GemFireMemcachedServer}
- *   which enables memcached clients to connect and store data in GemFire distributed system.
- *   see {@link GemFireMemcachedServer} for other configuration options.</dd>
- *   <dd><U>Default</U>: "0" disables GemFireMemcachedServer</dd>
- *   <dd><U>Allowed values</U>: 0..65535</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="memcached-protocol"><dt>memcached-protocol</dt></a>
- *   <dd><U>Description</U>: Specifies the protocol used by {@link GemFireMemcachedServer}</dd>
- *   <dd><U>Default</U>: "ASCII"</dd>
- *   <dd><U>Allowed values</U>: "ASCII" "BINARY"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="memcached-bind-address"><dt>memcached-bind-address</dt></a>
- *   <dd><U>Description</U>: Specifies the bind address used by {@link GemFireMemcachedServer}</dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="redis-port"><dt>redis-port</dt></a>
- *   <dd><U>Description</U>: Specifies the port used by {@link GemFireRedisServer}
- *   which enables redis clients to connect and store data in GemFire distributed system.
- *   see {@link GemFireRedisServer} for other configuration options.</dd>
- *   <dd><U>Default</U>: "0" disables GemFireMemcachedServer</dd>
- *   <dd><U>Allowed values</U>: 0..65535</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="redis-bind-address"><dt>redis-bind-address</dt></a>
- *   <dd><U>Description</U>: Specifies the bind address used by {@link GemFireRedisServer}</dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="redis-password"><dt>redis-password</dt></a>
- *   <dd><U>Description</U>: Specifies the password to authenticate a client of {@link GemFireRedisServer}</dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <B>Asynchronous Message Properties</B>
- *
- * <dl>
- *   <a name="async-distribution-timeout"><dt>async-distribution-timeout</dt></a>
- *   <dd><U>Description</U>: The number of milliseconds before a
- *   publishing process should attempt to distribute a cache operation
- *   before switching over to asynchronous messaging for this process.
- *   To enable asynchronous messaging, the value must be set above
- *   zero. If a thread that is publishing to the cache exceeds this value
- *   when attempting to distribute to this process, it will switch to
- *   asynchronous messaging until this process catches up, departs, or
- *   some specified limit is reached, such as <a href="#async-queue-timeout">
- *   async-queue-timeout</a> or <a href="#async-max-queue-size">
- *   async-max-queue-size</a>.
- *   </dd>
- *   <dd><U>Default</U>: "0"</dd>
- *   <dd><U>Allowed values</U>: 0..60000</dd>
- * </dl>
- * <dl>
- *   <a name="async-queue-timeout"><dt>async-queue-timeout</dt></a>
- *   <dd><U>Description</U>: The number of milliseconds a queuing
- *   publisher may enqueue asynchronous messages without any distribution
- *   to this process before that publisher requests this process to
- *   depart. If a queuing publisher has not been able to send this process
- *   any cache operations prior to the timeout, this process will attempt
- *   to close its cache and disconnect from the distributed system.
- *   </dd>
- *   <dd><U>Default</U>: "60000"</dd>
- *   <dd><U>Allowed values</U>: 0..86400000</dd>
- * </dl>
- * <dl>
- *   <a name="async-max-queue-size"><dt>async-max-queue-size</dt></a>
- *   <dd><U>Description</U>: The maximum size in megabytes that a
- *   publishing process should be allowed to asynchronously enqueue
- *   for this process before asking this process to depart from the
- *   distributed system.
- *   </dd>
- *   <dd><U>Default</U>: "8"</dd>
- *   <dd><U>Allowed values</U>: 0..1024</dd>
- * </dl>
- * 
- * <b>JMX Management</b>
- * 
- * <dl>
- *   <a name="jmx-manager"><dt>jmx-manager</dt></a>
- *   <dd><U>Description</U>: If true then this member is willing to be a jmx-manager.
- *   All the other jmx-manager properties will be used when it does become a manager.
- *   If this property is false then all other jmx-manager properties are ignored.
- *   </dd>
- *   <dd><U>Default</U>: "false except on locators"</dd>
- * </dl>
- *
- * <dl>
- *   <a name="jmx-manager-start"><dt>jmx-manager-start</dt></a>
- *   <dd><U>Description</U>: If true then this member will start a jmx manager when
- *   it creates a cache. Management tools like gfsh can be configured to connect
- *   to the jmx-manager. In most cases you should not set this because a jmx manager will
- *   automatically be started when needed on a member that sets "jmx-manager" to true.
- *   Ignored if jmx-manager is false.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-port"><dt>jmx-manager-port</dt></a>
- *   <dd><U>Description</U>: The port this jmx manager will listen to for client connections.
- *   If this property is set to zero then GemFire will not allow remote client connections 
- *   but you can alternatively use the standard system properties supported by the JVM 
- *   for configuring access from remote JMX clients.
- *   Ignored if jmx-manager is false.
- *   </dd>
- *   <dd><U>Default</U>: "1099"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl"><dt>jmx-manager-ssl</dt></a>
- *   <dd><U>Description</U>: If true and jmx-manager-port is not zero then the jmx-manager
- *   will only accept ssl connections. Note that the ssl-enabled property does not apply to the jmx-manager
- *   but the other ssl properties do. This allows ssl to be configured for just the jmx-manager
- *   without needing to configure it for the other GemFire connections.
- *   Ignored if jmx-manager is false.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Deprecated</U>: as of 8.0 use <a href="#jmx-manager-ssl-enabled"><code>jmx-manager-ssl-enabled</code></a> instead.</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-enabled"><dt>jmx-manager-ssl-enabled</dt></a>
- *   <dd><U>Description</U>: If true and jmx-manager-port is not zero then the jmx-manager
- *   will only accept ssl connections. Note that the ssl-enabled property does not apply to the jmx-manager
- *   but the other ssl properties do. This allows ssl to be configured for just the jmx-manager
- *   without needing to configure it for the other GemFire connections.
- *   Ignored if jmx-manager is false.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- * </dl> 
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-ciphers"><dt>jmx-manager-ssl-ciphers</dt></a>
- *   <dd><U>Description</U>: A space seperated list of the SSL cipher suites to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>   
- *   <dd><U>Default</U>: "any"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-protocols"><dt>jmx-manager-ssl-protocols</dt></a>
- *   <dd><U>Description</U>: A space seperated list of the SSL protocols to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: "any"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-require-authentication"><dt>jmx-manager-ssl-require-authentication</dt></a>
- *   <dd><U>Description</U>: If false, allow ciphers that do not require the client
- *   side of the connection to be authenticated.
- *   </dd>   
- *   <dd><U>Default</U>: "true"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-keystore"><dt>jmx-manager-ssl-keystore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing
- *   certificate and private key.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-keystore-type"><dt>jmx-manager-ssl-keystore-type</dt></a>
- *   <dd><U>Description</U>For Java keystore file format, this property has the
- *   value jks (or JKS).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-keystore-password"><dt>jmx-manager-ssl-keystore-password</dt></a>
- *   <dd><U>Description</U>Password to access the private key from the keystore
- *   file specified by javax.net.ssl.keyStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-truststore"><dt>jmx-manager-ssl-truststore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing the
- *   collection of CA certificates trusted by manager (trust store).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-ssl-truststore-password"><dt>jmx-manager-ssl-truststore-password</dt></a>
- *   <dd><U>Description</U>Password to unlock the keystore file (store password)
- *   specified by javax.net.ssl.trustStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-bind-address"><dt>jmx-manager-bind-address</dt></a>
- *   <dd><U>Description</U>: By default the jmx-manager when configured with a port will listen
- *   on all the local host's addresses. You can use this property to configure what ip address
- *   or host name the jmx-manager will listen on. In addition, if the embedded http server is
- *   started, it will also bind to this address if it is set.
- *   Ignored if jmx-manager is false or jmx-manager-port is zero.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-hostname-for-clients"><dt>jmx-manager-hostname-for-clients</dt></a>
- *   <dd><U>Description</U>: Lets you control what hostname will be given to clients that ask
- *   the locator for the location of a jmx manager. By default the ip address that the jmx-manager
- *   reports is used. But for clients on a different network this property allows you to configure
- *   a different hostname that will be given to clients.
- *   Ignored if jmx-manager is false or jmx-manager-port is zero.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="jmx-manager-password-file"><dt>jmx-manager-password-file</dt></a>
- *   <dd><U>Description</U>: By default the jmx-manager will allow clients without credentials to connect.
- *   If this property is set to the name of a file then only clients that connect with credentials that
- *   match an entry in this file will be allowed.
- *   Most JVMs require that the file is only readable by the owner.
- *   For more information about the format of this file see Oracle's documentation of the
- *   com.sun.management.jmxremote.password.file system property.
- *   Ignored if jmx-manager is false or if jmx-manager-port is zero.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- *
- * <dl>
- *   <a name="jmx-manager-access-file"><dt>jmx-manager-access-file</dt></a>
- *   <dd><U>Description</U>: By default the jmx-manager will allow full access to all mbeans by any client.
- *   If this property is set to the name of a file then it can restrict clients to only being able to read
- *   mbeans; they will not be able to modify mbeans. The access level can be configured differently in this
- *   file for each user name defined in the password file.
- *   For more information about the format of this file see Oracle's documentation of the
- *   com.sun.management.jmxremote.access.file system property.
- *   Ignored if jmx-manager is false or if jmx-manager-port is zero.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- * </dl>
- *
- * <dl>
- *   <a name="jmx-manager-http-port"><dt>jmx-manager-http-port</dt></a>
- *   <dd><U>Description</U>: If non-zero then when the jmx manager is started, an embedded
- *   web server will also be started and will listen on this port.
- *   The web server is used to host the GemFire Pulse application.
- *   If you are hosting the Pulse web app in your own web server, then disable
- *   this embedded server by setting this property to zero.
- *   Ignored if jmx-manager is false.
- *   </dd>
- *   <dd><U>Default</U>: "7070"</dd>
- *   <dd><U>Deprecated</U>: as of 8.0 use <a href="#http-service-port"><code>http-service-port</code></a> instead.</dd>
- * </dl>
- *
- * <dl>
- *   <a name="jmx-manager-update-rate"><dt>jmx-manager-update-rate</dt></a>
- *   <dd><U>Description</U>: The rate, in milliseconds, at which this member will push updates
- *   to any jmx managers. Currently this value should be greater than or equal to the
- *   statistic-sample-rate. Setting this value too high will cause stale values to be
- *   seen by gfsh and pulse.
- *   </dd>
- *   <dd><U>Default</U>: "2000"</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="http-service-port"><dt>http-service-port</dt></a>
- *   <dd><U>Description</U>: Specifies the port used by the GemFire HTTP service. If
- *   configured with non-zero value, then an HTTP service will listen on this port.
- *   A value of "0" disables Gemfire HTTP service.
- *   </dd>
- *   <dd><U>Default</U>: "7070" </dd>
- *   <dd><U>Allowed values</U>: 0..65535</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="http-service-bind-address"><dt>http-service-bind-address</dt></a>
- *   <dd><U>Description</U>: The address where the GemFire HTTP service will listen
- *   for remote connections. One can use this property to configure what ip
- *   address or host name the HTTP service will listen on. When not set, by
- *   default the HTTP service will listen on the local host's address.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <b> HTTP Service SSL Configuration </b>
- * 
- * <dl>
- *   <a name="http-service-ssl-enabled"><dt>http-service-ssl-enabled</dt></a>
- *   <dd><U>Description</U>: Specifies if http service is started with separate ssl configuration.
- *   If not specified, global property cluster-ssl-enabled (and its other related properties) are used
- *   to secure http service. All http-service-ssl-* properties are inherited from cluster-ssl-* properties. 
- *   User can ovverride them using specific http-service-ssl-* property.
- *   </dd>
- *   <dd><U>Default</U>: <code>false</code></dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl> 
- * 
- * <dl>
- *   <a name="http-service-ssl-ciphers"><dt>http-service-ssl-ciphers</dt></a>
- *   <dd><U>Description</U>: A space separated list of the SSL cipher suites to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="http-service-ssl-protocols"><dt>http-service-ssl-protocols</dt></a>
- *   <dd><U>Description</U>: A space separated list of the SSL protocols to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="http-service-ssl-require-authentication"><dt>http-service-ssl-require-authentication</dt></a>
- *   <dd><U>Description</U>: If false, allow ciphers that do not require the client
- *   side of the connection to be authenticated.
- *   </dd>
- *   <dd><U>Default</U>: <code>false</code></dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="http-service-ssl-keystore"><dt>http-service-ssl-keystore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing
- *   certificate and private key.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="http-service-ssl-keystore-type"><dt>http-service-ssl-keystore-type</dt></a>
- *   <dd><U>Description</U>For Java keystore file format, this property has the
- *   value jks (or JKS).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="http-service-ssl-keystore-password"><dt>http-service-ssl-keystore-password</dt></a>
- *   <dd><U>Description</U>Password to access the private key from the keystore
- *   file specified by javax.net.ssl.keyStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="http-service-ssl-truststore"><dt>http-service-ssl-truststore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing the
- *   collection of CA certificates trusted by server (trust store).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="http-service-ssl-truststore-password"><dt>http-service-ssl-truststore-password</dt></a>
- *   <dd><U>Description</U>Password to unlock the keystore file (store password)
- *   specified by javax.net.ssl.trustStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="start-dev-rest-api"><dt>start-dev-rest-api</dt></a>
- *   <dd><U>Description</U>: If true then developer(API) REST service will be
- *   started when cache is created. REST service can be configured using
- *   <code>http-service-port</code> and <code>http-service-bind-address</code>
- *   properties.</dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <b>Off-Heap Memory</b>
- * 
- * <dl>
- *   <a name="off-heap-memory-size"><dt>off-heap-memory-size</dt></a>
- *   <dd><U>Description</U>: The total size of off-heap memory specified as
- *   off-heap-memory-size=<n>[g|m]. <n> is the size. [g|m] indicates
- *   whether the size should be interpreted as gigabytes or megabytes.
- *   By default no off-heap memory is allocated.
- *   A non-zero value will cause that much memory to be allocated from the operating
- *   system and reserved for off-heap use.
- *   </dd>
- *   <dd><U>Default</U>: <code>""</code></dd>
- *   <dd><U>Since</U>: 9.0</dd>
- * </dl>
- * 
- * <b>Cluster Configuration Service</b>
- * <dl>
- *   <a name="enable-cluster-configuration"><dt>enable-cluster-configuration</dt></a>
- *   <dd><U>Description</U>: "true" causes creation of cluster configuration service on dedicated locators. The cluster configuration service on dedicated locator(s) 
- *   would serve the configuration to new members joining the distributed system and also save the configuration changes caused by the Gfsh commands.
- *   This property is only applicable to dedicated locators. 
- *   </dd>
- *   <dd><U>Default</U>: "true"</dd> 
- *   <dd><U>Allowed values</U>: true or false</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="use-cluster-configuration"><dt>use-cluster-configuration</dt></a>
- *   <dd><U>Description</U>: This property is only applicable for data members (non client and non locator) 
- *   "true" causes a member to request and uses the configuration from cluster configuration services running on dedicated locators. 
- *   "false" causes a member to not request the configuration from the configuration services running on the locator(s).
- *   </dd>
- *   <dd><U>Default</U>: "true"</dd> 
- *   <dd><U>Allowed values</U>: true or false</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="load-cluster-configuration-from-dir"><dt>load-cluster-configuration-from-dir</dt></a>
- *   <dd><U>Description</U>: "true" causes loading of cluster configuration from "cluster_config" directory in the locator. 
- *   This property is only applicable to dedicated locators which have "enable-cluster-configuration" set to true.
- *   </dd>
- *   <dd><U>Default</U>: "false"</dd>
- *   <dd><U>Allowed values</U>: true or false</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- *  * <dl>
- *   <a name="cluster-configuration-dir"><dt>cluster-configuration-dir</dt></a>
- *   <dd><U>Description</U>: This property specifies the directory in which the cluster configuration related disk-store and artifacts are stored  
- *   This property is only applicable to dedicated locators which have "enable-cluster-configuration" set to true.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Allowed values</U></dd>
- *   <dd><U>Since</U>: 8.1</dd>
- * </dl>
- * 
- * <b> Server SSL Configuration </b>
- * 
- * <dl>
- *   <a name="server-ssl-enabled"><dt>server-ssl-enabled</dt></a>
- *   <dd><U>Description</U>: Specifies if server is started with separate ssl configuration.
- *   If not specified global property ssl-enabled (and its other related properties) are used
- *   to create server socket
- *   </dd>
- *   <dd><U>Default</U>: <code>false</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl> 
- * 
- * <dl>
- *   <a name="server-ssl-ciphers"><dt>server-ssl-ciphers</dt></a>
- *   <dd><U>Description</U>: A space seperated list of the SSL cipher suites to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="server-ssl-protocols"><dt>server-ssl-protocols</dt></a>
- *   <dd><U>Description</U>: A space seperated list of the SSL protocols to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="server-ssl-require-authentication"><dt>server-ssl-require-authentication</dt></a>
- *   <dd><U>Description</U>: If false, allow ciphers that do not require the client
- *   side of the connection to be authenticated.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="server-ssl-keystore"><dt>server-ssl-keystore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing
- *   certificate and private key.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="server-ssl-keystore-type"><dt>server-ssl-keystore-type</dt></a>
- *   <dd><U>Description</U>For Java keystore file format, this property has the
- *   value jks (or JKS).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="server-ssl-keystore-password"><dt>server-ssl-keystore-password</dt></a>
- *   <dd><U>Description</U>Password to access the private key from the keystore
- *   file specified by javax.net.ssl.keyStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="server-ssl-truststore"><dt>server-ssl-truststore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing the
- *   collection of CA certificates trusted by server (trust store).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="server-ssl-truststore-password"><dt>server-ssl-truststore-password</dt></a>
- *   <dd><U>Description</U>Password to unlock the keystore file (store password)
- *   specified by javax.net.ssl.trustStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <b> Gateway SSL Configuration </b>
- * 
- * <dl>
- *   <a name="gateway-ssl-enabled"><dt>gateway-ssl-enabled</dt></a>
- *   <dd><U>Description</U>: Specifies if gateway is started with separate ssl configuration.
- *   If not specified global property ssl-enabled (and its other related properties) are used
- *   to create gateway socket
- *   </dd>
- *   <dd><U>Default</U>: <code>false</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl> 
- * 
- * <dl>
- *   <a name="gateway-ssl-ciphers"><dt>gateway-ssl-ciphers</dt></a>
- *   <dd><U>Description</U>: A space seperated list of the SSL cipher suites to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="gateway-ssl-protocols"><dt>gateway-ssl-protocols</dt></a>
- *   <dd><U>Description</U>: A space seperated list of the SSL protocols to enable.
- *   Those listed must be supported by the available providers.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- *  
- * <dl>
- *   <a name="gateway-ssl-require-authentication"><dt>gateway-ssl-require-authentication</dt></a>
- *   <dd><U>Description</U>: If false, allow ciphers that do not require the Gateway Sender
- *   side of the connection to be authenticated.
- *   </dd>
- *   <dd><U>Default</U>: <code>any</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="gateway-ssl-keystore"><dt>gateway-ssl-keystore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing
- *   certificate and private key.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="gateway-ssl-keystore-type"><dt>gateway-ssl-keystore-type</dt></a>
- *   <dd><U>Description</U>For Java keystore file format, this property has the
- *   value jks (or JKS).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="gateway-ssl-keystore-password"><dt>gateway-ssl-keystore-password</dt></a>
- *   <dd><U>Description</U>Password to access the private key from the keystore
- *   file specified by javax.net.ssl.keyStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="gateway-ssl-truststore"><dt>gateway-ssl-truststore</dt></a>
- *   <dd><U>Description</U>Location of the Java keystore file containing the
- *   collection of CA certificates trusted by server (trust store).
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="gateway-ssl-truststore-password"><dt>gateway-ssl-truststore-password</dt></a>
- *   <dd><U>Description</U>Password to unlock the keystore file (store password)
- *   specified by javax.net.ssl.trustStore.
- *   </dd>
- *   <dd><U>Default</U>: ""</dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- * <b>Miscellaneous</b> 
- *
- * <dl>
- *   <a name="lock-memory"><dt>lock-memory</dt></a>
- *   <dd><U>Description</U>: Include this option to lock GemFire heap and off-heap memory pages into RAM.
- *   This prevents the operating system from swapping the pages out to disk, which can cause sever
- *   performance degradation. When you use this command, also configure the operating system limits for
- *   locked memory.
- *   </dd>
- *   <dd><U>Default</U>: <code>"false"</code></dd>
- *   <dd><U>Since</U>: 9.0</dd>
- * </dl>
- * 
- * <dl>
- *   <a name="deploy-working-dir"><dt>deploy-working-dir</dt></a>
- *   <dd><U>Description</U>: Specifies the working directory which this
- *   distributed member will use to persist deployed JAR files.  This directory
- *   should be unchanged when restarting the member so that it can read what
- *   was previously persisted. The default is the current working directory
- *   as determined by <code>System.getProperty("user.dir")</code>.
- *   </dd>
- *   <dd><U>Default</U>: <code>System.getProperty("user.dir")</code></dd>
- *   <dd><U>Since</U>: 7.0</dd>
- * </dl>
- *
- * <dl>
- *   <a name="user-command-packages"><dt>user-command-packages</dt></a>
- *   <dd><U>Description</U>: A comma separated list of Java packages that
- *   contain classes implementing the <code>CommandMarker</code> interface.
- *   Matching classes will be loaded when the VM starts and will be available
- *   in the GFSH command-line utility.
- *   </dd>
- *   <dd><U>Default</U>: <code>""</code></dd>
- *   <dd><U>Since</U>: 8.0</dd>
- * </dl>
- * 
- *
  * @since GemFire 3.0
  */
 public abstract class DistributedSystem implements StatisticsFactory {


Mime
View raw message