Installing Riak CS

A fully functional Riak CS system is comprised of Riak CS, Stanchion, and Riak. Riak CS runs only on 64-bit platforms. The supported operating systems include Ubuntu 10.04, Ubuntu 11.04, CentOS 5, and CentOS 6. Riak CS is not supported on Microsoft Windows. You can install Riak CS on a single node or using an automated deployment tool.

For those of you like videos, here's a video that demonstrates a typical Riak CS installation.

Installing Riak CS on a Node

As a licensed Riak CS customer, you can use your Basho provided credentials to access Riak CS from the downloads section of the Basho help desk website.

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

Note

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

Installing Riak CS on Ubuntu

The following command installs Riak CS on a machine running either Debian or Ubuntu.

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

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

Installing Riak CS on CentOS

The following command installs Riak CS on a machine running CentOS.

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

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

Installing Stanchion

In a Riak CS system, Stanchion is installed on only one of the nodes in the system. Running Stanchion on more than one node can lead to problems if Riak CS nodes are configured to communicate using multiple Stanchion nodes. In this situation, the uniqueness of bucket names and user email addresses might not be enforced, which, in turn, could lead to unexpected behavior. Use the commands in the section for your operating system to install a pre-built Stanchion package on the node you choose for Stanchion.

Installing Stanchion on Ubuntu

The following command installs Stanchion on a machine running Ubuntu.

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

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

Installing Riak CS on CentOS

The following command installs Stanchion on a machine running either Red Hat linux or CentOS.

sudo rpm -Uvh <stanchion-package.rpm>

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

Note

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

Installing Riak

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

What's Next?

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