Fork me on GitHub

Get HyperDex

HyperDex is freely available and may be installed in seconds on many common platforms. Follow the instructions on this page to install HyperDex from pre-compiled packages or from source tarballs.

First, select your platform from among the following choices:

CentOS installation instructions

To install on CentOS, run the following commands as root:

cat >> /etc/yum.conf << EOF
[hyperdex]
name=hyperdex

baseurl=http://centos.hyperdex.org/base/\$basearch/\$releasever
enabled=1
gpgcheck=1
EOF

rpm --import http://centos.hyperdex.org/hyperdex.gpg.key
yum install -y epel-release
yum install -y hyperdex python-hyperdex-admin python-hyperdex-client

Debian installation instructions

To install HyperDex on Wheezy, run the following commands as root:

wget -O - http://debian.hyperdex.org/hyperdex.gpg.key | apt-key add -
cat >> /etc/apt/sources.list.d/hyperdex.list << EOF

deb [arch=amd64] http://debian.hyperdex.org wheezy main
EOF
apt-get update
apt-get install -y hyperdex python-hyperdex-admin python-hyperdex-client

Fedora installation instructions

To install on Fedora, run the following commands as root:

cat >> /etc/yum.conf << EOF
[hyperdex]
name=hyperdex
baseurl=http://fedora.hyperdex.org/base/\$basearch/\$releasever

enabled=1
gpgcheck=1
EOF
rpm --import http://fedora.hyperdex.org/hyperdex.gpg.key
yum install -y hyperdex python-hyperdex-admin python-hyperdex-client

OS X installation instructions

To install on Fedora, install HomeBrew, then run the following commands:

brew tap HyperDex/hyperdex && brew install hyperdex

Ubuntu installation instructions

Which release of Ubuntu are you using?

To install HyperDex on Ubuntu 12.04, run the following commands as root:

wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
cat >> /etc/apt/sources.list.d/hyperdex.list << EOF

deb [arch=amd64] http://ubuntu.hyperdex.org precise main
EOF
apt-get update
apt-get install -y hyperdex python-hyperdex-admin python-hyperdex-client

To install HyperDex on Ubuntu 14.04, run the following commands as root:

wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
cat >> /etc/apt/sources.list.d/hyperdex.list << EOF

deb [arch=amd64] http://ubuntu.hyperdex.org trusty main
EOF
apt-get update
apt-get install -y hyperdex python-hyperdex-admin python-hyperdex-client

Installing from source

Building from source is recommended when prebuilt packages are unsuitable or unavailable for your environment. Before installing HyperDex, we'll first install the prerequisites (prompts with "#" must be run as root).

Note: Some of these prerequisites may be available pre-packaged in your Linux distribution. You should check with your package manager and use it if the correct packages are available.
  • Google Glog Requires version 0.3.x. This package is often available in package managers as libgoogle-glog-dev or glog-devel.

    $ wget https://google-glog.googlecode.com/files/glog-0.3.3.tar.gz
    $ tar xzf glog-0.3.3.tar.gz
    $ cd glog-0.3.3
    $ ./configure
    $ make
    # make install
  • libpopt Any recent version. This package is often available in package managers as libpopt-dev or popt-devel.

    $ wget http://rpm5.org/files/popt/popt-1.16.tar.gz
    $ tar xzf popt-1.16.tar.gz
    $ cd popt-1.16
    $ ./configure
    $ make
    # make install

Great! You've installed the prerequisites, now let's install HyperDex from source itself. First, let's tell the build process where we put the dependencies:

$ export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/
  • libpo6-0.7.0.tar.gz
    $ wget http://hyperdex.org/src/libpo6-0.7.0.tar.gz
    $ tar xzf libpo6-0.7.0.tar.gz
    $ cd libpo6-0.7.0
    $ ./configure
    $ make
    # make install
  • libe-0.10.1.tar.gz
    $ wget http://hyperdex.org/src/libe-0.10.1.tar.gz
    $ tar xzf libe-0.10.1.tar.gz
    $ cd libe-0.10.1
    $ ./configure
    $ make
    # make install
  • busybee-0.6.0.tar.gz
    $ wget http://hyperdex.org/src/busybee-0.6.0.tar.gz
    $ tar xzf busybee-0.6.0.tar.gz
    $ cd busybee-0.6.0
    $ ./configure
    $ make
    # make install
  • hyperleveldb-1.2.2.tar.gz
    $ wget http://hyperdex.org/src/hyperleveldb-1.2.2.tar.gz
    $ tar xzf hyperleveldb-1.2.2.tar.gz
    $ cd hyperleveldb-1.2.2
    $ ./configure
    $ make
    # make install
  • replicant-0.7.1.tar.gz
    $ wget http://hyperdex.org/src/replicant-0.7.1.tar.gz
    $ tar xzf replicant-0.7.1.tar.gz
    $ cd replicant-0.7.1
    $ ./configure
    $ make
    # make install
  • libtreadstone-0.2.0.tar.gz
    $ wget http://hyperdex.org/src/libtreadstone-0.2.0.tar.gz
    $ tar xzf libtreadstone-0.2.0.tar.gz
    $ cd libtreadstone-0.2.0
    $ ./configure
    $ make
    # make install
  • libmacaroons-0.3.0.tar.gz
    $ wget http://hyperdex.org/src/libmacaroons-0.3.0.tar.gz
    $ tar xzf libmacaroons-0.3.0.tar.gz
    $ cd libmacaroons-0.3.0
    $ ./configure
    $ make
    # make install
  • hyperdex-1.7.1.tar.gz
    $ wget http://hyperdex.org/src/hyperdex-1.7.1.tar.gz
    $ tar xzf hyperdex-1.7.1.tar.gz
    $ cd hyperdex-1.7.1
    $ ./configure
    $ make
    # make install

Downloaded. Now what?

Now that you have HyperDex installed, check out the HyperDex Quick Start Tutorial.

Looking for HyperDex Warp and ACID transactions?

Install the hyperdex-warp package instead of the hyperdex package in the above instructions for an evaluation version of Warp. Then, checkout the HyperDex Warp Transactions Tutorial.

HyperDex Warp extends the open source HyperDex system with ACID transactions. We currently provide a free copy of HyperDex Warp for pre-production testing and evaluation.

Note:

The free evaluation copy of HyperDex Warp contains no code for fault-tolerance! Feel free to download, test, and hack with the evaluation copy of Warp to see if it's right for you, but please don't use it in production. To obtain a license for the full copy of HyperDex Warp, please contact us.

The HyperDex package (sans Warp) is completely open source and includes the fault tolerance code that is disabled in Warp. We encourage you to use this package as it is suitable for production environments.

Client Bindings

HyperDex includes client bindings for some popular native and scripting languages.

C/C++

C and C++ drivers are installed by default.

Python

Python bindings are included in the package python-hypderdex-client or by running ./configure --enable-python-bindings for a source install or by installing python-hyperdex-client and python-hyperdex-admin. The Mongo Veneer becomes available when both packages are installed.

Java

Java bindings are available by running ./configure --enable-java-bindings for a source install or by installing java-hyperdex-client.

Node

Node bindings are available by running npm install hyperdex-client

Ruby

Ruby bindings are available by running ./configure --enable-ruby-bindings for a source install or by installing ruby-hyperdex-client.

Go

Go bindings are available in the /bindings/go/ directory of the source distribution.