3.2. Starting the Database


VoltDB Home » Documentation » Administrator's Guide

3.2. Starting the Database

Once you create the deployment file, you are ready to start a VoltDB database cluster[1] for the first time using the voltdb create command. You issue this command, specifying the same deployment file and host on each node of the cluster. For example:

$ voltdb create --deployment=deployment.xml \ 1
                --host=voltsvr1 \             2
                --license=~/license.xml       3

On the command line, you specify four arguments:


The deployment file, which specifies the physical layout of the cluster and configures specific VoltDB features


One node of the cluster identified as the "host", to coordinate the initial startup of the cluster


The license file (when using the VoltDB Enterprise Edition)

What happens when you start the database is that each server contacts the named "host" server. The host then:

  1. Waits until the necessary number of servers (as specified in the deployment file) are connected

  2. Creates the network mesh between the servers

  3. Distributes the deployment file to ensure all nodes are using the same configuration

At this point, the cluster is fully initialized and the "host" ends its special role and becomes a peer to all the other nodes. All nodes in the cluster then write an informational message to the console verifying that the database is ready:

Server completed initialization.

[1] When testing with a single server, several of the command line arguments have defaults and can be left out. However, in production when starting a multi-node cluster, the arguments are required.