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 HyperDex on CentOS, append the following to /etc/yum.conf

[hyperdex]
name=hyperdex
baseurl=http://centos.hyperdex.org/base/$basearch/$releasever
enabled=1
gpgcheck=0

Debian installation instructions

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

$ sudo su -
# wget -O - http://debian.hyperdex.org/hyperdex.gpg.key | apt-key add -
# wget -O /etc/apt/sources.list.d/hyperdex.list http://debian.hyperdex.org/wheezy.list
# apt-get update
# apt-get install hyperdex

Fedora installation instructions

To install HyperDex on Fedora, append the following to /etc/yum.conf

[hyperdex]
name=hyperdex
baseurl=http://fedora.hyperdex.org/base/$basearch/$releasever
enabled=1
gpgcheck=0

Ubuntu installation instructions

Which release of Ubuntu are you using?

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

$ sudo su -
# wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
# wget -O /etc/apt/sources.list.d/hyperdex.list http://ubuntu.hyperdex.org/precise.list
# apt-get update
# apt-get install hyperdex

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

$ sudo su -
# wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
# wget -O /etc/apt/sources.list.d/hyperdex.list http://ubuntu.hyperdex.org/quantal.list
# apt-get update
# apt-get install hyperdex

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

$ sudo su -
# wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
# wget -O /etc/apt/sources.list.d/hyperdex.list http://ubuntu.hyperdex.org/raring.list
# apt-get update
# apt-get install hyperdex

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

$ sudo su -
# wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
# wget -O /etc/apt/sources.list.d/hyperdex.list http://ubuntu.hyperdex.org/saucy.list
# apt-get update
# apt-get install hyperdex

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

$ sudo su -
# wget -O - http://ubuntu.hyperdex.org/hyperdex.gpg.key | apt-key add -
# wget -O /etc/apt/sources.list.d/hyperdex.list http://ubuntu.hyperdex.org/trusty.list
# apt-get update
# apt-get install hyperdex

OS X installation instructions

To install on Mac OS X, use HomeBrew. First, take a look at the Homebrew installation instructions. Once you have Homebrew installed, installing HyperDex is just two commands:

$ brew tap HyperDex/hyperdex
$ brew install hyperdex

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
  • json-c Tested with 0.10.x and 0.11.x. This package is often available in package managers as libjson0-dev or json-c-devel.

    $ tar xzf json-c-json-c-0.11-20130402.tar.gz
    $ cd json-c-json-c-0.11-20130402
    $ ./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.5.0.tar.gz
    $ wget http://hyperdex.org/src/libpo6-0.5.1.tar.gz
    $ tar xzf libpo6-0.5.0.tar.gz
    $ cd libpo6-0.5.0
    $ ./configure
    $ make
    # make install
  • libe-0.8.0.tar.gz
    $ wget http://hyperdex.org/src/libe-0.8.0.tar.gz
    $ tar xzf libe-0.8.0.tar.gz
    $ cd libe-0.8.0
    $ ./configure
    $ make
    # make install
  • busybee-0.5.0.tar.gz
    $ wget http://hyperdex.org/src/busybee-0.5.0.tar.gz
    $ tar xzf busybee-0.5.0.tar.gz
    $ cd busybee-0.5.0
    $ ./configure
    $ make
    # make install
  • hyperleveldb-1.2.0.tar.gz
    $ wget http://hyperdex.org/src/hyperleveldb-1.2.0.tar.gz
    $ tar xzf hyperleveldb-1.2.0.tar.gz
    $ cd hyperleveldb-1.2.0
    $ ./configure
    $ make
    # make install
  • replicant-0.6.2.tar.gz
    $ wget http://hyperdex.org/src/replicant-0.6.2.tar.gz
    $ tar xzf replicant-0.6.2.tar.gz
    $ cd replicant-0.6.2
    $ ./configure
    $ make
    # make install
  • hyperdex-1.4.0.tar.gz
    $ wget http://hyperdex.org/src/hyperdex-1.4.0.tar.gz
    $ tar xzf hyperdex-1.4.0.tar.gz
    $ cd hyperdex-1.4.0
    $ ./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.

Java

Java bindings are available for testing by running ./configure --enable-java-bindings for a source install.

Ruby

Ruby bindings are available for testing by running ./configure --enable-ruby-bindings for a source install.

Go

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