This article is outdated and may not work correctly for current operating systems or software.
RethinkDB is a NoSQL database that stores data as JSON documents. It has a super intuitive query language and has features commonly available in traditional RDBMS like "table joins" and "group by". This tutorial will explain how to setup a RethinkDB cluster using 3 Vultr VPS servers running Ubuntu 14.04.
Create a new Vultr startup script using the following content as a template.
#!/usr/bin/env bash
echo ">>> Installing RethinkDB<<<"
# Add RethinkDB Repo to list of Repos
source /etc/lsb-release && echo "deb http://download.rethinkdb.com/apt $DISTRIB_CODENAME main" | sudo tee /etc/apt/sources.list.d/rethinkdb.list
wget -qO- http://download.rethinkdb.com/apt/pubkey.gpg | sudo apt-key add -
# Update Apt Repo & Install RethinkDB
sudo apt-get update
sudo apt-get install -qq rethinkdb
Spin up a Vultr VM instance by picking any Server Type, Location, and Server Size of your choice. For the choice of Operating System, make sure to select Ubuntu 14.04 x64 and check the Enable Private Network option. Also MAKE SURE to select the startup script created above before placing your order.
Once your new VM instance is ready, connect to it from a terminal/command-prompt via SSH.
ssh root@[vultr-ip-address]
When prompted for your password, use the initial password under "server info" tab from Vultr admin.
You can update your password by typing passwd and hitting the ENTER key. Ubuntu will prompt you for a new password (this way you can choose something that you easily remember).
Start RethinkDB by running command below. Note that we're "binding to all" so that we don't run into issues when trying to access RethinkDB's web admin interface.
rethinkdb --bind all
Once RethinkDB is started, you access it either by command-line or a web interface.
To access via web, use port 8080 by typing http://[vultr-ip-address]:8080 in the address bar of your web browser. You should see RethinkDB's awesome web administration tool.
To access via command-line, start a new terminal/command-prompt session and connect to the server via SSH as explained previously. Then, issue the command rethinkdb admin join 127.0.0.1:29015. Make sure to use port 29015.
We will be using the web interface going forward to manipulate the database. Access it by browsing to http://[vultr-ip-address]:8080 and click on the "Tables" link. You will see that RethinkDB already installed a "test" database. Click on the "Data Explorer" link and run below command to delete the "test" database.
r.dbDrop('test')
While still on the "Data Explorer" section of RethinkDB's admin, create a new database named "tweetDB" by running the code below.
r.dbCreate('tweetDB')
Next, create a "tweets" table.
r.db('tweetDB').tableCreate('tweets')
Insert some records into the "tweets" table.
r.db('tweetDB').table('tweets').insert([
{
name: 'Lami',
twitterHandle: 'mrLami',
message: 'Best cloud hosting on the planet - vultr'
},
{
name: 'Vultr Hosting',
twitterHandle: '@TheVultr',
message: '50% off on new instances - coupon - tgif'
}
])
Query "tweets" table to see results.
r.db('tweetDB').table('tweets')
You should see the following under tree view (with different id's).
[
{
"id": "6afe436c-7db4-4c86-b4db-3279acb3265d" ,
"message": "50% off on new instances - coupon - tgif" ,
"name": "Vultr Hosting" ,
"twitterHandle": "@TheVultr"
} ,
{
"id": "fd328cd5-d9f4-40ee-8a32-880cd8cda15d" ,
"message": "Best cloud hosting on the planet - vultr" ,
"name": "Lami" ,
"twitterHandle": "mrLami"
}
]
Spin up a second and third machine using instructions from the "Installation", "Connect To Your New VM Instance" and "Accessing Database" sections of this guide. Make sure to delete the "test" database on each of the new instances, and DO NOT add any new databases to them.
After deleting the "test" database from second and third instances, go back to their command prompts and stop RethinkDB by issuing Ctrl + C (or Cmd + C on Mac). Now start RethinkDB again on these instances by using the below command (we're basically telling new second and third instances to join the first).
$ rethinkdb --join [ip-of-first-vultr-vm]:29015 --bind all
On the second and third instances, access web admin interfaces, and go to the "Data Explorer" section. Run the following query to get a list of tweets.
r.db('tweetDB').table('tweets')
You will see that they have already replicated from the master (first VM setup) instance.
Although RethinkDB is still in its infancy at the time of this writing, it holds a lot of promise and has a powerful web-based administration interface that makes arduous tasks usually involved with scaling a database (sharding, replication) easily accomplished with just a few clicks.
For further reading, visit the RethinkDB Docs. Also check out #rethinkdb IRC channel to learn more from the community.