You use JDBC connection properties, connection boot properties, and Java system properties to configure SnappyData members and connections.
SnappyData configuration properties are divided into the following property types:
Connection properties. Connection properties configure the features of a SnappyData member or a SnappyData client connection when you start or connect to a SnappyData member. You can define connection properties directly in the JDBC connection URL (or in the "connect" command in an interactive SnappyData session). You can also define connection properties in the
gemfirexd.propertiesfile or as Java system properties. For example, use -J-Dproperty_name=property_value when you execute a
snappyutility. Or, use the JAVA_ARGS environment variable to define a Java system property for an interactive
You must add a prefix to certain connection property names in order to specify those properties as Java system properties. See Property Prefixes.
Connection properties can be further categorized as either boot properties or client properties:
Boot properties. A boot connection property configures features of a SnappyData member, and can only be applied along with the first connection that starts a SnappyData member. Boot properties have no effect when they are specified on connections to a member after the member has started. Boot properties have no effect when they are specified on a thin client connection.
Client properties. A client connection property configures features of the client connection itself and can be used with the JDBC thin client drive (for example, using a JDBC thin client connection URL or the
connect clientcommand from an interactive
System properties. Certain SnappyData configuration properties must be specified either as Java system properties (using -J-Dproperty_name=property_value with a
snappyutility or setting JAVA_ARGS="-Dproperty_name=property_value" for an interactive
snappysession). You cannot define these properties in a JDBC URL connection. Many of SnappyData system properties affect features of the SnappyData member at boot time and can be optionally defined in the gemfirexd.properties file. See the property description to determine whether or not a system property can be defined in gemfirexd.properties.
The names of SnappyData system properties always include the
snappydata.prefix. For example, all properties that configure LDAP server information for user authentication must be specified as Java system properties, rather than JDBC properties, when you boot a server.
Certain properties have additional behaviors or restrictions. See the individual property descriptions for more information.
You must add a prefix to connection and boot property names when you define those properties as Java system properties. The Prefix row in each property table lists a prefix value (
gemfire.) when one is required. Do not use an indicated prefix when you specify the property in a connection string.
If no prefix is specified, use only the indicated property name in all circumstances. For example, use "host-data" whether you define this property in gemfirexd.properties, as a Java system property, or as a property definition for FabricServer.
Using Non-ASCII Strings in SnappyData Property Files
You can specify Unicode (non-ASCII) characters in SnappyData property files by using a
\uXXXX escape sequence. For a supplementary character, you need two escape sequences, one for each of the two UTF-16 code units. The XXXX denotes the 4 hexadecimal digits for the value of the UTF-16 code unit. For example, a properties file might have the following entries:
s1=hello there s2=\u3053\u3093\u306b\u3061\u306f pre For example, in `gemfirexd.properties`, you might write: ```pre log-file=my\u00df.log
to indicate the desired property definition of
If you have edited and saved the file in a non-ASCII encoding, you can convert it to ASCII with the
native2ascii tool included in your Oracle Java distribution. For example, you might want to do this when editing a properties file in Shift_JIS, a popular Japanese encoding.
List of Property Names
Below is the list of all the configuration properties and links for each property reference page.