No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

##Install Riak on Windows Azure (Work in Progress)

Steps to install Riak on Centos VMs using the Windows Azure platform:

  1. Create CentOS VMs using the Preview Management Portal
  2. Connect to the Centos VMs using PuTTY or SSH
  3. Configure Centos and Riak using a shell script
  4. Cluster Riak & load test data

Creating CentOS VMs

Sign up for Virtual Machine Preview feature

You will need to sign up for the Windows Azure Virtual Machines preview feature in order to create a virtual machine. You can also sign up for a free trial account if you do not have a Windows Azure account.

  1. Navigate to and sign in with your Windows Azure account.

  2. Click preview features to view the available previews.

  3. Scroll down to Virtual Machines & Virtual Networks and click try it now.

  4. Select your subscription and click the check.

Create a virtual machine running CentOS Linux
  1. Login to the Windows Azure (Preview) Management Portal using your Windows Azure account.

  2. In the Management Portal, at the bottom left of the web page, click +New, click Virtual Machine, and then click From Gallery.

  3. Select a CentOS or Ubuntu virtual machine image from Platform Images, and then click the next arrow at the bottom right of the page.

  4. On the VM Configuration page, provide the following information:

    • Provide a Virtual Machine Name, such as "testlinuxvm".
    • Specify a New User Name, such as "newuser", which will be added to the Sudoers list file.
      • ** Do NOT use the username "Riak" ** as it may conflict with the installation package
    • In the New Password box, type a strong password.
    • In the Confirm Password box, retype the password.
    • Select the appropriate Size from the drop down list.
    • Click the next arrow to continue.

  5. On the VM Mode page, provide the following information:

    • If this is the first node, select the "STANDALONE VIRTUAL MACHINE" radio button. Otherwise, select the "CONNECT TO EXISTING VIRTUAL MACHINE" radio button, and select the first node in the drop down list.*
    • In the DNS Name box, type a valid DNS address. For example, "testlinuxvm"
    • In the Storage Account box, select Use Automatically Generated Storage Account.
    • In the Region/Affinity Group/Virtual Network box, select a region where this virtual image will be hosted.
    • Click the next arrow to continue.

  6. On the VM Options page, select (none) in the Availability Set box. Click the check mark to continue.

  7. Wait while Windows Azure prepares your virtual machine.

Configure Endpoints

Once the virtual machine is created you must configure endpoints in order to remotely connect.

  1. In the Management Portal, click Virtual Machines, then click the name of your new VM, then click Endpoints.

  2. If this is the first node, click Add Endpoint, leave 'Add Endpoint' check and hit the right arrow, and fill out the next form as follows:

    • Name: https
    • Protocol: leave set to 'TCP'
    • Public Port: 443
    • Private Port: 8069

Connect to CentOS or Ubuntu VMs using PuTTY or SSH

When the virtual machine has been provisioned and the endpoints configured you can connect to it using SSH or PuTTY.

Connecting Using SSH

For Linux & Mac Users:

$ ssh -o ServerAliveInterval=180

Enter the user's password.

For Windows Users, use PuTTY:

If you are using a Windows computer, connect to the VM using PuTTY. PuTTY can be downloaded from the PuTTY Download Page.

  1. Download and save putty.exe to a directory on your computer. Open a command prompt, navigate to that folder, and execute putty.exe.

  2. Enter the SSH DETAILS as found on the Node's Dashboard, i.e., "" for the Host Name and "22" for the Port.

Install Riak and configure using a shell script

  1. On each node, once you've connected using the steps above:


sudo su -

curl -s | sh

Configure Riak using Riak Control

You can either use Riak Control or Command Line to add nodes to your Riak Cluster. If you wish to add nodes via the command line, skip down to the section entitled "Cluster Riak using Command Line"

  1. Find the dns name, and the "Deployment ID" in the virtual machine dashboard of the VM you created the https endpoint for. -i.e. dns: -i.e. Deployment ID: 7ea145743aeb4402a088da1234567890

  2. Visit in your browser

  3. Ender 'admin' as the username, and the "Deployement ID" as the password.

  4. Select 'Cluster' on the left.

  5. Add vms which also have the Riak software installed and configured by entering riak@yourhostnamehere in the input box, and clicking 'Add Node'

    • i.e. riak@basho-centos1
    • ( Use the short name of each vm, not the DNS name )

You now have a Riak cluster on Azure

Configure Riak using Command Line

If you have already followed the instructions in the section "Configure Riak using Riak Control", skip this section.

First, SSH into the second, and subsequent nodes, and on each node:


riak-admin cluster join riak@yourhostnamehere

( Where 'yourhostnamehere' is the short name of the first node in your cluster )

( NOTE: The host you choose can actually be any host that has already joined the cluster, the first host has no special significance, but it's important not to attempt to join a node that hasn't joined a cluster yet, or else you'll make a second cluster; thus we use the first node for these instructions. )

After all the nodes have have been joined to the first node via the previous command, connect to any of the nodes via SSH or PuTTY and execute the following:

riak-admin cluster plan

Verify all the nodes are listed as expected, If this looks good:

riak-admin cluster commit

To check the status of clustering use:

riak-admin member-status

You now have a Riak cluster on Azure

Load test data

Execute on any one of the nodes:

curl -s | sh

Visit DNS address listed on the dashboard, at the port we opened as an endpoint:

Further Reading: