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:
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
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
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
To install on OS X, install HomeBrew, then run the following commands:
brew tap HyperDex/hyperdex && brew install hyperdex
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
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).
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/
$ wget https://hyperdex.org/src/libpo6-0.8.0.tar.gz $ tar xzf libpo6-0.8.0.tar.gz $ cd libpo6-0.8.0 $ ./configure $ make # make install
$ wget https://hyperdex.org/src/libe-0.11.0.tar.gz $ tar xzf libe-0.11.0.tar.gz $ cd libe-0.11.0 $ ./configure $ make # make install
$ wget https://hyperdex.org/src/busybee-0.7.0.tar.gz $ tar xzf busybee-0.7.0.tar.gz $ cd busybee-0.7.0 $ ./configure $ make # make install
$ wget https://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
$ wget https://hyperdex.org/src/replicant-0.8.1.tar.gz $ tar xzf replicant-0.8.1.tar.gz $ cd replicant-0.8.1 $ ./configure $ make # make install
$ wget https://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
$ wget https://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
$ wget https://hyperdex.org/src/hyperdex-1.8.1.tar.gz $ tar xzf hyperdex-1.8.1.tar.gz $ cd hyperdex-1.8.1 $ ./configure $ make # make install
Now that you have HyperDex installed, check out the HyperDex Quick Start Tutorial.
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.
HyperDex includes client bindings for some popular native and scripting languages.
C and C++ drivers are installed by default.
Python bindings are included in the package
python-hyperdex-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 bindings are available by running ./configure
--enable-java-bindings for a source install or by installing
java-hyperdex-client.
Node bindings are available by running npm install hyperdex-client
Ruby bindings are available by running ./configure
--enable-ruby-bindings for a source install or by installing
ruby-hyperdex-client.
Go bindings are available in the /bindings/go/ directory of
the source distribution.