A.4. Path Configuration Options

Documentation

VoltDB Home » Documentation » Administrator's Guide

A.4. Path Configuration Options

The running database uses a number of disk locations to store information associated with runtime features, such as export, network partition detection, and snapshots. You can control which paths are used for these disk-based activities. The path configuration options include:

  • VoltDB root

  • Snapshots path

  • Export overflow path

  • Command log path

  • Command log snapshots path

A.4.1. VoltDB Root

VoltDB defines a root directory for any disk-based activity which is required at runtime. This directory also serves as a root for all other path definitions that take the default or use a relative path specification.

If you do not specify a location for the root directory on the command line, VoltDB uses the current working directory as a default. Normally, you specify the location of the root directory using the --dir flag on the voltdb init and voltdb start commands. The root directory is then the subdirectory voltdbroot within the specified location. (If the subfolder does not exist, VoltDB creates it.) See the section on "Configuring Paths for Runtime Features" in the Using VoltDB manual for details.

A.4.2. Snapshots Path

The snapshots path specifies where automated and network partition snapshots are stored. The default snapshots path is the "snapshots" subfolder of the VoltDB root directory. You can specify an alternate path for snapshots using the <snapshots> child element of the <paths> tag in the configuration file.

A.4.3. Export Overflow Path

The export overflow path specifies where overflow data is stored if the export queue gets too large. The default export overflow path is the "export_overflow" subfolder of the VoltDB root directory. You can specify an alternate path using the <exportoverflow> child element of the <paths> tag in the configuration file.

See the chapter on "Exporting Live Data" in the Using VoltDB manual for more information on export overflow.

A.4.4. Command Log Path

The command log path specifies where the command logs are stored when command logging is enabled. The default command log path is the "command_log" subfolder of the VoltDB root directory. However, for production use, it is strongly recommended that the command logs be written to a dedicated device, not the same device used for snapshotting or export overflow. You can specify an alternate path using the <commandlog> child element of the <paths> tag in the configuration file.

See the chapter on "Command Logging and Recovery" in the Using VoltDB manual for more information on command logging.

A.4.5. Command Log Snapshots Path

The command log snapshots path specifies where the snapshots created by command logging are stored. The default path is the "command_log_snapshot" subfolder of the VoltDB root directory. (Note that command log snapshots are stored separately from automated snapshots.) You can specify an alternate path using the <commandlogsnapshot> child element of the <paths> tag in the configuration file.

See the chapter on "Command Logging and Recovery" in the Using VoltDB manual for more information on command logging.