Download Riak 2.0

Installing Riak CS

A fully functional Riak CS system is comprised of Riak CS, Stanchion, and Riak. The supported operating systems include Ubuntu, CentOS, Fedora, Solaris, SmartOS, FreeBSD, and OS X. Riak CS is not supported on Microsoft Windows.

You can install Riak CS on a single node or using an automated deployment tool. Any Riak CS installation involves three components, all of which must be installed separately:

Installing Riak

If you have not yet installed Riak, follow the Riak Installation documentation to do so.

Installing Riak CS on a Node

Riak CS and Stanchion packages are available on the Download Riak CS page. Similarly, Riak packages are available on the Download Riak page.

After downloading Riak CS, Stanchion, and Riak, install them using your operating system's package management commands.

Note on Riak CS and public ports

Riak CS is not designed to function directly on TCP port 80, and it should not be operated in a manner that exposes it directly to the public internet. Instead, consider a load-balancing solution such as a dedicated device HAProxy or Nginx between Riak CS and the outside world.

Installing Riak CS on Mac OS X

To install Riak CS on OS X, first download the appropriate package from the downloads page:

curl -O http://s3.amazonaws.com/downloads.basho.com/riak-cs/1.4/1.5.1/osx/10.8/riak-cs-1.5.1-OSX-x86_64.tar.gz

Then, unpack the downloaded tarball:

tar -xvzf riak-cs-1.5.1-OSX-x86_64.tar.gz

At this point, you can move on to configuring Riak CS.

Installing Riak CS on Debian or Ubuntu

On Debian or Ubuntu, you can either use apt or install the .deb package manually.

Installing Using apt (recommended)

First, install the signing key:

curl http://apt.basho.com/gpg/basho.apt.key | sudo apt-key add -

Then, add the Basho repository to your apt sources list (and update them):

sudo bash -c "echo deb http://apt.basho.com $(lsb_release -sc) main > /etc/apt/sources.list.d/basho.list"
sudo apt-get update

Now, install Riak CS:

sudo apt-get install riak-cs

At this point, you can move on to installing Stancion.

Installing the .deb Package Manually (not recommended)

To install manually, use dpkg:

sudo dpkg -i <riak-cs-package.deb>

Replace <riak-cs-package.deb> with the actual filename for the package you are installing.

At this point, you can move on to installing Stancion.

Installing Riak CS on RHEL or CentOS

On RHEL or CentOS, you can either use yum or install the .rpm package manually.

Installing Using yum (recommended)

For CentOS/RHEL 6:

sudo yum install http://yum.basho.com/gpg/basho-release-6-1.noarch.rpm

For CentOS/RHEL 5:

sudo yum install http://yum.basho.com/gpg/basho-release-5-1.noarch.rpm

Once the .rpm package has been installed, install Riak CS:

sudo yum install riak-cs

At this point, you can move on to installing Stancion.

Installing the .rpm Package Manually (not recommended)

rpm -Uvh <riak-cs-package.rpm>

Replace <riak-cs-package.rpm> with the actual filename for the package you are installing.

At this point, you can move on to installing Stancion.

Installing Stanchion on a Node

Stanchion is an application that manages globally unique entities within a Riak CS cluster. It performs actions such as ensuring unique user accounts and bucket names across the whole system. Riak CS cannot be used without Stanchion.

All Riak CS nodes must be configured to communicate with a single Stanchion node. Although multiple Stanchion instances may be installed and running within a cluster, even one on each node, only one may be actively used by the cluster. Running multiple instances of Stanchion simultaneously can produce a variety of problems such as the inability to create user accounts and buckets or the inability to enfore their uniqueness.

Because only one Stanchion instance can be used at any given time, it's not uncommon for a load balancer to be used to handle Stanchion failover in the event that the primary Stanchion node becomes unavailable. You can achieve this by specifying a load balancer IP as the Stanchion UP in each Riak CS node's app.config. This load balancer must be configured to send all requests to a single Stanchion node, failing over to a secondary Stanchion node if the primary is unavailable. More details can be found in Specifying the Stanchion Node.

Installing Stanchion on Mac OS X

First, download the appropriate package from the downloads page.

curl -O http://s3.amazonaws.com/downloads.basho.com/stanchion/1.4/1.4.3/osx/10.8/stanchion-1.4.3-OSX-x86_64.tar.gz

Then, unpack the downloaded tarball:

stanchion-1.4.3-OSX-x86_64.tar.gz

At this point, you can move on to configuring Riak CS.

Installing Stanchion on Debian or Ubuntu

On Debian or Ubuntu, you can either use apt or install the .deb package manually.

Installing Using apt (recommended)

First, install the signing key:

curl http://apt.basho.com/gpg/basho.apt.key | sudo apt-key add -

If the signing key and apt repository have already been added, add the Basho repository to your apt sources list (and update them):

sudo bash -c "echo deb http://apt.basho.com $(lsb_release -sc) main > /etc/apt/sources.list.d/basho.list"
sudo apt-get update

Now, install Riak CS:

sudo apt-get install stanchion

At this point, you can move on to configuring Riak CS.

Installing the .deb Package Manually (not recommended)

sudo dpkg -i <stanchion-package.deb>

Replace <riak-cs-package.deb> with the actual filename for the package you are installing.

At this point, you can move on to configuring Riak CS.

Installing Stanchion on RHEL or CentOS

On RHEL or CentOS, you can either use yum or install the .rpm package manually.

Installing Using yum (recommended)

For CentOS/RHEL 6:

sudo yum install http://yum.basho.com/gpg/basho-release-6-1.noarch.rpm

For CentOS/RHEL 5:

sudo yum install http://yum.basho.com/gpg/basho-release-5-1.noarch.rpm

Once the .rpm package has been installed, install Stanchion:

sudo yum install stanchion

At this point, you can move on to configuring Riak CS.

Installing the .rpm Package Manually (not recommended)

sudo rpm -Uvh <stanchion-package.rpm>

Replace <stanchion-package.rpm> with the actual filename for the package you are installing.

At this point, you can move on to configuring Riak CS.

Note on SELinux

CentOS enables Security-Enhanced Linux (SELinux) by default. If you encounter errors during installation, try disabling SELinux.

What's Next?

Once you've completed installation of Riak CS and Riak, you're ready to learn more about Configuring Riak CS.