{"action":"created","comment":{"url":"https://api.github.com/repos/kaaproject/kaa/pulls/comments/71173672","id":71173672,"diff_hunk":"@@ -5,62 +5,115 @@ permalink: /:path/\n sort_idx: 30\n ---\n \n-* [Introduction](#introduction)\n-* [Cluster configuration](#cluster-configuration)\n-  * [List of properties](#list-of-properties)\n-  * [Kaa-node configuration](#kaa-node-configuration)\n-  * [Zookeeper configuration](#zookeeper-configuration)\n-  * [SQL database configuration](#sql-database-configuration)\n-  * [NoSQL database configuration](#nosql-database-configuration)\n-  * [Firewall rules configuration](#firewall-rules-configuration)\n+{% include variables.md %}\n \n-## Introduction\n+* TOC\n+{:toc}\n+\n+This guide describes configuration of Kaa cluster on Linux nodes.\n+\n+The guide contains instructions on how to configure kaa-node service and required third party components like Apache Zookeeper service, SQL and NoSQL databases.\n+\n+## Requirements\n+\n+In order to set up Kaa cluster you need to have at least 3 Linux nodes with ```kaa-node``` service installed on each of them to create a reliable cluster, refer to [Single node installation]({{root_url}}Administration-guide/System-installation/Single-node-installation/) guide for installation details. \n \n-This page describes how to setup and configure kaa-node cluster.\n+Also ```kaa-node``` service require some third party dependencies like SQL and NoSQL databases and Apache Zookeeper service, more details you can find in [Architecture overview]({{root_url}}Architecture-overview/). \n+You can find detailed instructions on how to install and configure Zookeeper service and one of supported SQL and NoSQL databases in [Single node installation]({{root_url}}Administration-guide/System-installation/Single-node-installation/#installation-steps) guide. \n+A set of databases (for example MongoDB + PostgreSQL) depends on your particular use case and some useful recommendations you can find in [Planning your deployment]({{root_url}}Administration-guide/System-installation/Planning-your-deployment/) guide.\n \n-In general cluster setup is similar to [single node setup](../Single-node-installation), except few details. We need at least 3 nodes to create a reliable cluster. For simplicity in this tutorial we will be using single instance of SQL and NoSQL databases, so this tutorial doesn't cover such themes like setting up Cassandra, MongoDB or PostgreSQL cluster setup. Let us assume that we have 3 nodes with Ubuntu 14.04 installed on each of them.\n+In this guide we assume that you had already set up your SQL and NoSQL database clusters, so this tutorial doesn't cover such themes like setting up ones for Cassandra, MongoDB or PostgreSQL. \n+Refer to official [Cassandra](http://docs.datastax.com/en/landing_page/doc/landing_page/current.html), [MongoDB](https://docs.mongodb.com/manual/) and [PostgreSQL](https://www.postgresql.org/docs/) documentation in order to setup corresponding database cluster.\n+\n+MariaDB come with out of the box master-master replication support thus we recommend to use this database in your Kaa cluster. ","path":"doc/Administration-guide/System-installation/Cluster-setup/index.md","position":35,"original_position":35,"commit_id":"41fa1ac32b3a99faac4352f0bbff62cec13a3b29","original_commit_id":"41fa1ac32b3a99faac4352f0bbff62cec13a3b29","user":{"login":"ashvayka","id":5016373,"avatar_url":"https://avatars.githubusercontent.com/u/5016373?v=3","gravatar_id":"","url":"https://api.github.com/users/ashvayka","html_url":"https://github.com/ashvayka","followers_url":"https://api.github.com/users/ashvayka/followers","following_url":"https://api.github.com/users/ashvayka/following{/other_user}","gists_url":"https://api.github.com/users/ashvayka/gists{/gist_id}","starred_url":"https://api.github.com/users/ashvayka/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ashvayka/subscriptions","organizations_url":"https://api.github.com/users/ashvayka/orgs","repos_url":"https://api.github.com/users/ashvayka/repos","events_url":"https://api.github.com/users/ashvayka/events{/privacy}","received_events_url":"https://api.github.com/users/ashvayka/received_events","type":"User","site_admin":false},"body":"\"with out of the box\" need to be replaces with \"with out-of-the-box\" to avoid confusion during reading. ","created_at":"2016-07-18T15:52:19Z","updated_at":"2016-07-18T15:52:19Z","html_url":"https://github.com/kaaproject/kaa/pull/763#discussion_r71173672","pull_request_url":"https://api.github.com/repos/kaaproject/kaa/pulls/763","_links":{"self":{"href":"https://api.github.com/repos/kaaproject/kaa/pulls/comments/71173672"},"html":{"href":"https://github.com/kaaproject/kaa/pull/763#discussion_r71173672"},"pull_request":{"href":"https://api.github.com/repos/kaaproject/kaa/pulls/763"}}},"pull_request":{"url":"https://api.github.com/repos/kaaproject/kaa/pulls/763","id":74055947,"html_url":"https://github.com/kaaproject/kaa/pull/763","diff_url":"https://github.com/kaaproject/kaa/pull/763.diff","patch_url":"https://github.com/kaaproject/kaa/pull/763.patch","issue_url":"https://api.github.com/repos/kaaproject/kaa/issues/763","number":763,"state":"open","locked":false,"title":"KAA-1178: Administration guide > Cluster setup","user":{"login":"krupet","id":6959834,"avatar_url":"https://avatars.githubusercontent.com/u/6959834?v=3","gravatar_id":"","url":"https://api.github.com/users/krupet","html_url":"https://github.com/krupet","followers_url":"https://api.github.com/users/krupet/followers","following_url":"https://api.github.com/users/krupet/following{/other_user}","gists_url":"https://api.github.com/users/krupet/gists{/gist_id}","starred_url":"https://api.github.com/users/krupet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krupet/subscriptions","organizations_url":"https://api.github.com/users/krupet/orgs","repos_url":"https://api.github.com/users/krupet/repos","events_url":"https://api.github.com/users/krupet/events{/privacy}","received_events_url":"https://api.github.com/users/krupet/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-06-16T10:20:49Z","updated_at":"2016-07-18T15:52:19Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5e58c5d55127e634e4a956218b9d3babd42094cd","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/kaaproject/kaa/pulls/763/commits","review_comments_url":"https://api.github.com/repos/kaaproject/kaa/pulls/763/comments","review_comment_url":"https://api.github.com/repos/kaaproject/kaa/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kaaproject/kaa/issues/763/comments","statuses_url":"https://api.github.com/repos/kaaproject/kaa/statuses/41fa1ac32b3a99faac4352f0bbff62cec13a3b29","head":{"label":"krupet:documentation/KAA-1178","ref":"documentation/KAA-1178","sha":"41fa1ac32b3a99faac4352f0bbff62cec13a3b29","user":{"login":"krupet","id":6959834,"avatar_url":"https://avatars.githubusercontent.com/u/6959834?v=3","gravatar_id":"","url":"https://api.github.com/users/krupet","html_url":"https://github.com/krupet","followers_url":"https://api.github.com/users/krupet/followers","following_url":"https://api.github.com/users/krupet/following{/other_user}","gists_url":"https://api.github.com/users/krupet/gists{/gist_id}","starred_url":"https://api.github.com/users/krupet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krupet/subscriptions","organizations_url":"https://api.github.com/users/krupet/orgs","repos_url":"https://api.github.com/users/krupet/repos","events_url":"https://api.github.com/users/krupet/events{/privacy}","received_events_url":"https://api.github.com/users/krupet/received_events","type":"User","site_admin":false},"repo":{"id":60511686,"name":"kaa","full_name":"krupet/kaa","owner":{"login":"krupet","id":6959834,"avatar_url":"https://avatars.githubusercontent.com/u/6959834?v=3","gravatar_id":"","url":"https://api.github.com/users/krupet","html_url":"https://github.com/krupet","followers_url":"https://api.github.com/users/krupet/followers","following_url":"https://api.github.com/users/krupet/following{/other_user}","gists_url":"https://api.github.com/users/krupet/gists{/gist_id}","starred_url":"https://api.github.com/users/krupet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krupet/subscriptions","organizations_url":"https://api.github.com/users/krupet/orgs","repos_url":"https://api.github.com/users/krupet/repos","events_url":"https://api.github.com/users/krupet/events{/privacy}","received_events_url":"https://api.github.com/users/krupet/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/krupet/kaa","description":"Kaa open-source middleware platform for building, managing, and integrating connected products with the Internet of Everything.","fork":true,"url":"https://api.github.com/repos/krupet/kaa","forks_url":"https://api.github.com/repos/krupet/kaa/forks","keys_url":"https://api.github.com/repos/krupet/kaa/keys{/key_id}","collaborators_url":"https://api.github.com/repos/krupet/kaa/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/krupet/kaa/teams","hooks_url":"https://api.github.com/repos/krupet/kaa/hooks","issue_events_url":"https://api.github.com/repos/krupet/kaa/issues/events{/number}","events_url":"https://api.github.com/repos/krupet/kaa/events","assignees_url":"https://api.github.com/repos/krupet/kaa/assignees{/user}","branches_url":"https://api.github.com/repos/krupet/kaa/branches{/branch}","tags_url":"https://api.github.com/repos/krupet/kaa/tags","blobs_url":"https://api.github.com/repos/krupet/kaa/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/krupet/kaa/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/krupet/kaa/git/refs{/sha}","trees_url":"https://api.github.com/repos/krupet/kaa/git/trees{/sha}","statuses_url":"https://api.github.com/repos/krupet/kaa/statuses/{sha}","languages_url":"https://api.github.com/repos/krupet/kaa/languages","stargazers_url":"https://api.github.com/repos/krupet/kaa/stargazers","contributors_url":"https://api.github.com/repos/krupet/kaa/contributors","subscribers_url":"https://api.github.com/repos/krupet/kaa/subscribers","subscription_url":"https://api.github.com/repos/krupet/kaa/subscription","commits_url":"https://api.github.com/repos/krupet/kaa/commits{/sha}","git_commits_url":"https://api.github.com/repos/krupet/kaa/git/commits{/sha}","comments_url":"https://api.github.com/repos/krupet/kaa/comments{/number}","issue_comment_url":"https://api.github.com/repos/krupet/kaa/issues/comments{/number}","contents_url":"https://api.github.com/repos/krupet/kaa/contents/{+path}","compare_url":"https://api.github.com/repos/krupet/kaa/compare/{base}...{head}","merges_url":"https://api.github.com/repos/krupet/kaa/merges","archive_url":"https://api.github.com/repos/krupet/kaa/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/krupet/kaa/downloads","issues_url":"https://api.github.com/repos/krupet/kaa/issues{/number}","pulls_url":"https://api.github.com/repos/krupet/kaa/pulls{/number}","milestones_url":"https://api.github.com/repos/krupet/kaa/milestones{/number}","notifications_url":"https://api.github.com/repos/krupet/kaa/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/krupet/kaa/labels{/name}","releases_url":"https://api.github.com/repos/krupet/kaa/releases{/id}","deployments_url":"https://api.github.com/repos/krupet/kaa/deployments","created_at":"2016-06-06T08:30:26Z","updated_at":"2016-06-06T08:30:37Z","pushed_at":"2016-07-18T09:32:54Z","git_url":"git://github.com/krupet/kaa.git","ssh_url":"git@github.com:krupet/kaa.git","clone_url":"https://github.com/krupet/kaa.git","svn_url":"https://github.com/krupet/kaa","homepage":"http://www.kaaproject.org","size":137751,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"kaaproject:develop","ref":"develop","sha":"b5032f4db546a2270d6a86c04bd326b9711003f5","user":{"login":"kaaproject","id":6984613,"avatar_url":"https://avatars.githubusercontent.com/u/6984613?v=3","gravatar_id":"","url":"https://api.github.com/users/kaaproject","html_url":"https://github.com/kaaproject","followers_url":"https://api.github.com/users/kaaproject/followers","following_url":"https://api.github.com/users/kaaproject/following{/other_user}","gists_url":"https://api.github.com/users/kaaproject/gists{/gist_id}","starred_url":"https://api.github.com/users/kaaproject/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kaaproject/subscriptions","organizations_url":"https://api.github.com/users/kaaproject/orgs","repos_url":"https://api.github.com/users/kaaproject/repos","events_url":"https://api.github.com/users/kaaproject/events{/privacy}","received_events_url":"https://api.github.com/users/kaaproject/received_events","type":"Organization","site_admin":false},"repo":{"id":17839346,"name":"kaa","full_name":"kaaproject/kaa","owner":{"login":"kaaproject","id":6984613,"avatar_url":"https://avatars.githubusercontent.com/u/6984613?v=3","gravatar_id":"","url":"https://api.github.com/users/kaaproject","html_url":"https://github.com/kaaproject","followers_url":"https://api.github.com/users/kaaproject/followers","following_url":"https://api.github.com/users/kaaproject/following{/other_user}","gists_url":"https://api.github.com/users/kaaproject/gists{/gist_id}","starred_url":"https://api.github.com/users/kaaproject/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kaaproject/subscriptions","organizations_url":"https://api.github.com/users/kaaproject/orgs","repos_url":"https://api.github.com/users/kaaproject/repos","events_url":"https://api.github.com/users/kaaproject/events{/privacy}","received_events_url":"https://api.github.com/users/kaaproject/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kaaproject/kaa","description":"Kaa open-source middleware platform for building, managing, and integrating connected products with the Internet of Everything.","fork":false,"url":"https://api.github.com/repos/kaaproject/kaa","forks_url":"https://api.github.com/repos/kaaproject/kaa/forks","keys_url":"https://api.github.com/repos/kaaproject/kaa/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kaaproject/kaa/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kaaproject/kaa/teams","hooks_url":"https://api.github.com/repos/kaaproject/kaa/hooks","issue_events_url":"https://api.github.com/repos/kaaproject/kaa/issues/events{/number}","events_url":"https://api.github.com/repos/kaaproject/kaa/events","assignees_url":"https://api.github.com/repos/kaaproject/kaa/assignees{/user}","branches_url":"https://api.github.com/repos/kaaproject/kaa/branches{/branch}","tags_url":"https://api.github.com/repos/kaaproject/kaa/tags","blobs_url":"https://api.github.com/repos/kaaproject/kaa/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kaaproject/kaa/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kaaproject/kaa/git/refs{/sha}","trees_url":"https://api.github.com/repos/kaaproject/kaa/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kaaproject/kaa/statuses/{sha}","languages_url":"https://api.github.com/repos/kaaproject/kaa/languages","stargazers_url":"https://api.github.com/repos/kaaproject/kaa/stargazers","contributors_url":"https://api.github.com/repos/kaaproject/kaa/contributors","subscribers_url":"https://api.github.com/repos/kaaproject/kaa/subscribers","subscription_url":"https://api.github.com/repos/kaaproject/kaa/subscription","commits_url":"https://api.github.com/repos/kaaproject/kaa/commits{/sha}","git_commits_url":"https://api.github.com/repos/kaaproject/kaa/git/commits{/sha}","comments_url":"https://api.github.com/repos/kaaproject/kaa/comments{/number}","issue_comment_url":"https://api.github.com/repos/kaaproject/kaa/issues/comments{/number}","contents_url":"https://api.github.com/repos/kaaproject/kaa/contents/{+path}","compare_url":"https://api.github.com/repos/kaaproject/kaa/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kaaproject/kaa/merges","archive_url":"https://api.github.com/repos/kaaproject/kaa/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kaaproject/kaa/downloads","issues_url":"https://api.github.com/repos/kaaproject/kaa/issues{/number}","pulls_url":"https://api.github.com/repos/kaaproject/kaa/pulls{/number}","milestones_url":"https://api.github.com/repos/kaaproject/kaa/milestones{/number}","notifications_url":"https://api.github.com/repos/kaaproject/kaa/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kaaproject/kaa/labels{/name}","releases_url":"https://api.github.com/repos/kaaproject/kaa/releases{/id}","deployments_url":"https://api.github.com/repos/kaaproject/kaa/deployments","created_at":"2014-03-17T18:48:31Z","updated_at":"2016-07-17T20:01:25Z","pushed_at":"2016-07-18T15:25:41Z","git_url":"git://github.com/kaaproject/kaa.git","ssh_url":"git@github.com:kaaproject/kaa.git","clone_url":"https://github.com/kaaproject/kaa.git","svn_url":"https://github.com/kaaproject/kaa","homepage":"http://www.kaaproject.org","size":146752,"stargazers_count":329,"watchers_count":329,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":125,"mirror_url":null,"open_issues_count":26,"forks":125,"open_issues":26,"watchers":329,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kaaproject/kaa/pulls/763"},"html":{"href":"https://github.com/kaaproject/kaa/pull/763"},"issue":{"href":"https://api.github.com/repos/kaaproject/kaa/issues/763"},"comments":{"href":"https://api.github.com/repos/kaaproject/kaa/issues/763/comments"},"review_comments":{"href":"https://api.github.com/repos/kaaproject/kaa/pulls/763/comments"},"review_comment":{"href":"https://api.github.com/repos/kaaproject/kaa/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kaaproject/kaa/pulls/763/commits"},"statuses":{"href":"https://api.github.com/repos/kaaproject/kaa/statuses/41fa1ac32b3a99faac4352f0bbff62cec13a3b29"}}}}
{"actor":{"display_login":"ashvayka"}}