The configuration file describes the physical configuration of a VoltDB database cluster at runtime, including the number of sites per hosts and K-safety value, among other things. This appendix describes the syntax for each component within the configuration file.
The configuration file is a fully-conformant XML file. If you are unfamiliar with XML, see Section E.1, “Understanding XML Syntax” for a brief explanation of XML syntax.
The configuration file is a fully-conformant XML file. XML files consist of a series of nested elements identified by beginning and ending "tags". The beginning tag is the element name enclosed in angle brackets and the ending tag is the same except that the element name is preceded by a slash. For example:
<deployment> <cluster> </cluster> </deployment>
Elements can be nested. In the preceding example cluster
is a child of the element
deployment
.
Elements can also have attributes that are specified within the starting tag by the attribute
name, an equals sign, and its value enclosed in single or double quotes. In the following example the
kfactor
and sitesperhost
attributes of the cluster element are assigned values of "1"
and "12", respectively.
<deployment> <cluster kfactor="1" sitesperhost="12"> </cluster> </deployment>
Finally, as a shorthand, elements that do not contain any children can be entered without an ending tag by adding the
slash to the end of the initial tag. In the following example, the cluster
and heartbeat
tags use this form of shorthand:
<deployment> <cluster kfactor="1" sitesperhost="12"/> <heartbeat timeout="10"/> </deployment>
For complete information about the XML standard and XML syntax, see the official XML site at http://www.w3.org/XML/
.