- \n
- 3 Servers Ubuntu 18.04\/16.04<\/li>\n
- \n
- hakase-riak01\u00a0\u00a0\u00a0\u00a0 10.1.1.10<\/li>\n
- hakase-riak02\u00a0\u00a0\u00a0\u00a0 10.1.1.11<\/li>\n
- hakase-riak03\u00a0\u00a0\u00a0\u00a0 10.1.1.12<\/li>\n<\/ul>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do?<\/h2>\n
- \n
- Install Riak KV on Ubuntu 18.04<\/li>\n
- Basic Riak KV Configuration<\/li>\n
- Setup Riak KV Cluster<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Install Riak KV on Ubuntu 18.04 LTS<\/h2>\n
The first step we will do for this guide is to install the Riak KV packages on all of the servers, so run all commands in this stage on all servers.<\/p>\n
We will install the Riak KV from the packagecloud repository, and will be using the Riak KV packages for Ubuntu Xenial version.<\/p>\n
Add the packagecloud key and install ‘apt-transport-https’.<\/p>\n
curl https:\/\/packagecloud.io\/gpg.key | sudo apt-key add -Now go to the ‘\/etc\/apt\/sources.list.d’ directory and create a new repository file ‘riak.list’.<\/p>\n
cd \/etc\/apt\/sources.list.d\/Paste Riak KV repository below.<\/p>\n
# this file was generated by packagecloud.io for \n# the repository at https:\/\/packagecloud.io\/basho\/riak \n \ndeb https:\/\/packagecloud.io\/basho\/riak\/ubuntu\/ xenial main \ndeb-src https:\/\/packagecloud.io\/basho\/riak\/ubuntu\/ xenial main<\/pre>\n
Save and exit.<\/p>\n
Update the repository and install the Riak KV packages using the apt command below.<\/p>\n
sudo apt updateWait for the installation.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04.png\" "\\"\\"")
<\/a><\/p>\nNote:<\/strong><\/p>\n
- \n
- Run all commands on this stage on all server nodes.<\/li>\n<\/ul>\n
Step 2 – Basic Configuration Riak KV<\/h2>\n
In this step, we will configure the Riak KV for our NoSQL cluster. Before configuring the Riak KV itself, we need to setup the open files limit on the Ubuntu system.<\/p>\n
Edit the ‘\/etc\/security\/limits.conf’ file using vim editor<\/a>.<\/p>\n
vim \/etc\/security\/limits.conf<\/code><\/pre>\nPaste configuration below to the end of the line.<\/p>\n
riak soft nofile 65536 \nriak hard nofile 200000<\/pre>\n
Save and exit.<\/p>\n
Now go to the ‘\/etc\/riak’ directory, edit the default configuration file ‘riak.conf’.<\/p>\n
cd \/etc\/riak\/Change the\u00a0default nodename ‘[email\u00a0protected]<\/a>‘ with ‘[email\u00a0protected]<\/a>‘.<\/p>\n
nodename = [email\u00a0protected]<\/a><\/code><\/pre>\nNow uncomment those schedulers lines below.<\/p>\n
erlang.schedulers.force_wakeup_interval = 500 \nerlang.schedulers.compaction_of_load = false<\/pre>\n
Uncomment the ‘ring_size’ line and leave it default ’64’.<\/p>\n
ring_size = 64<\/code><\/pre>\nChange the HTTP listener and protocol buffers with the ‘ServerIP’.<\/p>\n
listener.http.internal = 10.1.1.11:8098 \nlistener.protobuf.internal = 10.1.11.11:8087<\/pre>\n
Save and exit.<\/p>\n
Now test riak configurations, then start the riak service.<\/p>\n
riak chkconfigAnd the following is the result.<\/p>\n
![\"Start](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-1.png\" "\\"\\"")
<\/a><\/p>\nNext, we will test our riak service configuration by running commands below.<\/p>\n
riak pingMake sure you get the ‘pong’ result from the ‘riak ping’ command, and get the HTTP status code ‘200’ from the curl command.<\/p>\n
![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-2.png\" "\\"\\"")
<\/a><\/p>\nBasic configurations of Riak KV distributed NoSQL have been completed, and we’re ready to setup the Riak KV Cluster.<\/p>\n
Note:<\/strong><\/p>\n
- \n
- Run all commands on this stage on all server nodes.<\/li>\n<\/ul>\n
Step 3 – Setup Riak KV Cluster<\/h2>\n
In this step, we will setup the cluster by joining the ‘hakase-riak02’ and ‘hakase-riak03’ nodes to the first node.<\/p>\n
Second Node<\/h3>\n
On the ‘hakase-riak02’ node, run the riak-admin below.<\/p>\n
riak-admin cluster join [email\u00a0protected]<\/a><\/code><\/pre>\n![\"Setup](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-3.png\" "\\"\\"")
<\/a><\/p>\nNow back to the ‘hakase-riak01’ node, run riak-admin commands below.<\/p>\n
riak-admin cluster planAnd the ‘hakase-riak02’ node has been added to the cluster, check it using command below.<\/p>\n
riak-admin cluster status<\/code><\/pre>\n![\"riak-admin](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-4.png\" "\\"\\"")
<\/a><\/p>\nThird Node<\/h3>\n
On the ‘hakase-riak03’ node, run the riak-admin command below.<\/p>\n
riak-admin cluster join [email\u00a0protected]<\/a><\/code><\/pre>\n![\"Third](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-5.png\" "\\"\\"")
<\/a><\/p>\nNow back to the ‘hakase-riak01’ node, run riak-admin commands below.<\/p>\n
riak-admin cluster planAll server node ‘hakase-riak02’ and ‘hakase-riak03’ has been added to the cluster, check again using command below.<\/p>\n
riak-admin cluster status<\/code><\/pre>\nThe Riak KV cluster\u00a0installation and configuration has been completed.<\/p>\n
![\"iak](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-6.png\" "\\"\\"")
<\/a><\/p>\nStep 4 – Testing<\/h2>\n
The Riak KV NoSQL cluster has been created, now we want to test the cluster by uploading a data image to the cluster, and test to access from the other nodes to ensure data replication between all nodes.<\/p>\n
On the ‘hakase-riak01’ server, download an image using wget command below.<\/p>\n
cd ~\/Now upload the image to the Riak KV cluster using curl command<\/a>.<\/p>\n
curl -XPUT http:\/\/10.9.9.10:8098\/riak\/images\/hakase.jpg -H \"Content-type: image\/jpg\" --data-binary @hakase.jpg<\/code><\/pre>\n![\"Testing](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-setup-riak-kv-database-cluster-on-ubuntu-18-04-7.png\" "\\"\\"")
<\/a><\/p>\nOpen your web browser and type other nodes IP address, and you will get the same image.<\/p>\n
‘hakase-riak02’.<\/strong><\/p>\n
http:\/\/10.1.1.11:8098\/riak\/images\/hakase.jpg<\/strong><\/em><\/p>\n
- Run all commands on this stage on all server nodes.<\/li>\n<\/ul>\n
- Run all commands on this stage on all server nodes.<\/li>\n<\/ul>\n
![\"Install](\"https:\/\/www.howtoforge.com\/images\/how_to_setup_riak_kv_cluster_on_ubuntu_1804\/big\/1.png\" "\\"\\"")
<\/a><\/p>\n