VoltDB is distributed as a compressed tar archive. The file name identifies the edition (community or enterprise) and the version number. The best way to install VoltDB is to unpack the distribution kit as a folder in the home directory of your personal account, like so:
$ tar -zxvf voltdb-ent-6.5.tar.gz -C $HOME/
Installing into your personal directory gives you full access to the software and is most useful for development.
If you are installing VoltDB on a production server where the database will be run, you may want to install the
software into a standard system location so that the database cluster can be started with the same commands on all nodes.
The following shell commands install the VoltDB software in the folder
$ sudo tar -zxvf voltdb-ent-6.5.tar.gz -C /opt $ cd /opt $ sudo mv voltdb-ent-6.5 voltdb
Note that installing as root using the sudo command makes the installation folders read-only for non-privileged accounts. Which is why installing in $HOME is recommended for running the sample applications and other development activities.
When upgrading from a previous version of VoltDB — especially with an existing database — there are a few key steps you should take to ensure a smooth migration. The recommended steps for upgrading an existing database are:
Place the database in admin mode (voltadmin pause).
Perform a manual snapshot of the database (voltadmin save --blocking).
Shutdown the database (voltadmin shutdown).
Create a new database starting in admin mode (voltdb create --pause --force).
Restore the snapshot created in Step #2 (voltadmin restore).
Return the database to normal operations (voltadmin resume).
If you want to build the open source VoltDB software from source (for example, if you want to test recent development changes), you must first fetch the VoltDB source files. The VoltDB sources are stored in a GitHub repository.
The VoltDB sources are designed to build and run on 64-bit Linux-based or 64-bit Macintosh platforms. However, the build process has not been tested on all possible configurations. Attempts to build the sources on other operating systems may require changes to the build files and possibly to the sources as well.
Once you obtain the sources, use Ant 1.7 or later to build a new distribution kit for the current platform:
$ ant dist
The resulting distribution kit is created as
n.n.nn identifies the current version and build numbers. Use this file to install VoltDB according to
the instructions in Section 2.2, “Installing VoltDB”.