{"action":"created","comment":{"url":"https://api.github.com/repos/confluentinc/ksql/pulls/comments/176260212","pull_request_review_id":105932441,"id":176260212,"diff_hunk":"@@ -1,4 +1,86 @@\n .. _install_overview:\n \n Installing KSQL\n-===============\n\\ No newline at end of file\n+===============\n+\n+KSQL is a component of |cp| and the KSQL binaries are located at `https://www.confluent.io/download/ <https://www.confluent.io/download/>`_\n+as a part of the |cp| bundle.\n+\n+KSQL must have access to a running Kafka cluster, which can be on prem, |ccloud|, etc.\n+\n+Docker support\n+    You can deploy KSQL in Docker, however the current release does not yet ship with ready-to-use KSQL Docker images for\n+    production. These images are coming soon.\n+\n+.. _install_ksql-cli:\n+\n+---------------------\n+Starting the KSQL CLI\n+---------------------\n+\n+The KSQL CLI is a client that connects to the KSQL servers.\n+\n+You can start the KSQL CLI by providing the connection information to the KSQL server.\n+\n+.. code:: bash\n+\n+    $ <path-to-confluent>/bin/ksql http://localhost:8088\n+\n+After KSQL is started, your terminal should resemble this.\n+\n+.. include:: ../includes/ksql-includes.rst\n+    :start-line: 17\n+    :end-line: 38\n+\n+.. _install_ksql-server:\n+\n+------------------------\n+Starting the KSQL Server\n+------------------------\n+\n+The KSQL servers are run separately from the KSQL CLI client and Kafka brokers. You can deploy servers on remote machines,\n+VMs, or containers and then the CLI connects to these remote servers.\n+\n+You can add or remove servers from the same resource pool during live operations, to elastically scale query processing. You\n+can use different resource pools to support workload isolation. For example, you could deploy separate pools for production\n+and for testing.\n+\n+You can only connect to one KSQL server at a time. The KSQL CLI does not support automatic failover to another KSQL server.\n+\n+.. image:: ../img/client-server.png\n+    :align: center\n+\n+.. tip:: For development and testing purposes, you can use Confluent CLI to spin up services on a single host. For more\n+    information, see :ref:`quickstart`.\n+\n+Follow these instructions to start KSQL server.\n+\n+#.  Customize the KSQL ``ksql-server.properties`` file.  By default, the configuration file is located at ``/etc/ksql/ksql-server.properties``.\n+    The required parameters are ``bootstrap.servers`` and ``listeners``. You can also set any property the Kafka Streams\n+    API or the Kafka producer and consumer would understand. For a description of common configurations, see :ref:`configuring-ksql`.\n+\n+    .. tip:: KSQL servers that share the same ``command`` topic belong to the same resource pool. By default, KSQL servers\n+             use the ``ksql__commands`` command topic. To assign a server to a different pool, change the ``ksql.command.topic.suffix``\n+             setting. For example, if you change to ``ksql.command.topic.suffix = production_commands``, the command topic will be named","path":"docs/installation/installing.rst","position":66,"original_position":66,"commit_id":"896a5a8fb9aac31767a1e3e2b92ede31306ee946","original_commit_id":"8cfd40a4de62222923c45a436f50c15c4a8d7582","user":{"login":"apurvam","id":830220,"avatar_url":"https://avatars0.githubusercontent.com/u/830220?v=4","gravatar_id":"","url":"https://api.github.com/users/apurvam","html_url":"https://github.com/apurvam","followers_url":"https://api.github.com/users/apurvam/followers","following_url":"https://api.github.com/users/apurvam/following{/other_user}","gists_url":"https://api.github.com/users/apurvam/gists{/gist_id}","starred_url":"https://api.github.com/users/apurvam/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apurvam/subscriptions","organizations_url":"https://api.github.com/users/apurvam/orgs","repos_url":"https://api.github.com/users/apurvam/repos","events_url":"https://api.github.com/users/apurvam/events{/privacy}","received_events_url":"https://api.github.com/users/apurvam/received_events","type":"User","site_admin":false},"body":"This has changed. The command topic will be `_confluent-ksql-production_deployment_command_topic`.","created_at":"2018-03-21T22:32:00Z","updated_at":"2018-03-21T22:32:00Z","html_url":"https://github.com/confluentinc/ksql/pull/974#discussion_r176260212","pull_request_url":"https://api.github.com/repos/confluentinc/ksql/pulls/974","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/comments/176260212"},"html":{"href":"https://github.com/confluentinc/ksql/pull/974#discussion_r176260212"},"pull_request":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/974"}},"in_reply_to_id":175963335},"pull_request":{"url":"https://api.github.com/repos/confluentinc/ksql/pulls/974","id":175616315,"html_url":"https://github.com/confluentinc/ksql/pull/974","diff_url":"https://github.com/confluentinc/ksql/pull/974.diff","patch_url":"https://github.com/confluentinc/ksql/pull/974.patch","issue_url":"https://api.github.com/repos/confluentinc/ksql/issues/974","number":974,"state":"open","locked":false,"title":"[WIP] DOCS-344 - CLI and Server Installation, Architecture","user":{"login":"joel-hamill","id":11722533,"avatar_url":"https://avatars0.githubusercontent.com/u/11722533?v=4","gravatar_id":"","url":"https://api.github.com/users/joel-hamill","html_url":"https://github.com/joel-hamill","followers_url":"https://api.github.com/users/joel-hamill/followers","following_url":"https://api.github.com/users/joel-hamill/following{/other_user}","gists_url":"https://api.github.com/users/joel-hamill/gists{/gist_id}","starred_url":"https://api.github.com/users/joel-hamill/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/joel-hamill/subscriptions","organizations_url":"https://api.github.com/users/joel-hamill/orgs","repos_url":"https://api.github.com/users/joel-hamill/repos","events_url":"https://api.github.com/users/joel-hamill/events{/privacy}","received_events_url":"https://api.github.com/users/joel-hamill/received_events","type":"User","site_admin":false},"body":"Internal staging server: http://staging-docs.confluent.io.s3-website-us-west-2.amazonaws.com/PR/770/4.1.0/ksql/docs/installation/index.html","created_at":"2018-03-16T18:44:32Z","updated_at":"2018-03-21T22:32:00Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9de74b993836739868844d8ec2be9cc7b2f9253d","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/confluentinc/ksql/pulls/974/commits","review_comments_url":"https://api.github.com/repos/confluentinc/ksql/pulls/974/comments","review_comment_url":"https://api.github.com/repos/confluentinc/ksql/pulls/comments{/number}","comments_url":"https://api.github.com/repos/confluentinc/ksql/issues/974/comments","statuses_url":"https://api.github.com/repos/confluentinc/ksql/statuses/896a5a8fb9aac31767a1e3e2b92ede31306ee946","head":{"label":"confluentinc:joel-hamill/DOCS-344","ref":"joel-hamill/DOCS-344","sha":"896a5a8fb9aac31767a1e3e2b92ede31306ee946","user":{"login":"confluentinc","id":9439498,"avatar_url":"https://avatars0.githubusercontent.com/u/9439498?v=4","gravatar_id":"","url":"https://api.github.com/users/confluentinc","html_url":"https://github.com/confluentinc","followers_url":"https://api.github.com/users/confluentinc/followers","following_url":"https://api.github.com/users/confluentinc/following{/other_user}","gists_url":"https://api.github.com/users/confluentinc/gists{/gist_id}","starred_url":"https://api.github.com/users/confluentinc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/confluentinc/subscriptions","organizations_url":"https://api.github.com/users/confluentinc/orgs","repos_url":"https://api.github.com/users/confluentinc/repos","events_url":"https://api.github.com/users/confluentinc/events{/privacy}","received_events_url":"https://api.github.com/users/confluentinc/received_events","type":"Organization","site_admin":false},"repo":{"id":69400326,"name":"ksql","full_name":"confluentinc/ksql","owner":{"login":"confluentinc","id":9439498,"avatar_url":"https://avatars0.githubusercontent.com/u/9439498?v=4","gravatar_id":"","url":"https://api.github.com/users/confluentinc","html_url":"https://github.com/confluentinc","followers_url":"https://api.github.com/users/confluentinc/followers","following_url":"https://api.github.com/users/confluentinc/following{/other_user}","gists_url":"https://api.github.com/users/confluentinc/gists{/gist_id}","starred_url":"https://api.github.com/users/confluentinc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/confluentinc/subscriptions","organizations_url":"https://api.github.com/users/confluentinc/orgs","repos_url":"https://api.github.com/users/confluentinc/repos","events_url":"https://api.github.com/users/confluentinc/events{/privacy}","received_events_url":"https://api.github.com/users/confluentinc/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/confluentinc/ksql","description":"KSQL - the Streaming SQL Engine for Apache Kafka ","fork":false,"url":"https://api.github.com/repos/confluentinc/ksql","forks_url":"https://api.github.com/repos/confluentinc/ksql/forks","keys_url":"https://api.github.com/repos/confluentinc/ksql/keys{/key_id}","collaborators_url":"https://api.github.com/repos/confluentinc/ksql/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/confluentinc/ksql/teams","hooks_url":"https://api.github.com/repos/confluentinc/ksql/hooks","issue_events_url":"https://api.github.com/repos/confluentinc/ksql/issues/events{/number}","events_url":"https://api.github.com/repos/confluentinc/ksql/events","assignees_url":"https://api.github.com/repos/confluentinc/ksql/assignees{/user}","branches_url":"https://api.github.com/repos/confluentinc/ksql/branches{/branch}","tags_url":"https://api.github.com/repos/confluentinc/ksql/tags","blobs_url":"https://api.github.com/repos/confluentinc/ksql/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/confluentinc/ksql/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/confluentinc/ksql/git/refs{/sha}","trees_url":"https://api.github.com/repos/confluentinc/ksql/git/trees{/sha}","statuses_url":"https://api.github.com/repos/confluentinc/ksql/statuses/{sha}","languages_url":"https://api.github.com/repos/confluentinc/ksql/languages","stargazers_url":"https://api.github.com/repos/confluentinc/ksql/stargazers","contributors_url":"https://api.github.com/repos/confluentinc/ksql/contributors","subscribers_url":"https://api.github.com/repos/confluentinc/ksql/subscribers","subscription_url":"https://api.github.com/repos/confluentinc/ksql/subscription","commits_url":"https://api.github.com/repos/confluentinc/ksql/commits{/sha}","git_commits_url":"https://api.github.com/repos/confluentinc/ksql/git/commits{/sha}","comments_url":"https://api.github.com/repos/confluentinc/ksql/comments{/number}","issue_comment_url":"https://api.github.com/repos/confluentinc/ksql/issues/comments{/number}","contents_url":"https://api.github.com/repos/confluentinc/ksql/contents/{+path}","compare_url":"https://api.github.com/repos/confluentinc/ksql/compare/{base}...{head}","merges_url":"https://api.github.com/repos/confluentinc/ksql/merges","archive_url":"https://api.github.com/repos/confluentinc/ksql/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/confluentinc/ksql/downloads","issues_url":"https://api.github.com/repos/confluentinc/ksql/issues{/number}","pulls_url":"https://api.github.com/repos/confluentinc/ksql/pulls{/number}","milestones_url":"https://api.github.com/repos/confluentinc/ksql/milestones{/number}","notifications_url":"https://api.github.com/repos/confluentinc/ksql/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/confluentinc/ksql/labels{/name}","releases_url":"https://api.github.com/repos/confluentinc/ksql/releases{/id}","deployments_url":"https://api.github.com/repos/confluentinc/ksql/deployments","created_at":"2016-09-27T21:30:15Z","updated_at":"2018-03-21T19:05:40Z","pushed_at":"2018-03-21T22:29:47Z","git_url":"git://github.com/confluentinc/ksql.git","ssh_url":"git@github.com:confluentinc/ksql.git","clone_url":"https://github.com/confluentinc/ksql.git","svn_url":"https://github.com/confluentinc/ksql","homepage":"","size":6534,"stargazers_count":1486,"watchers_count":1486,"language":"Java","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":268,"mirror_url":null,"archived":false,"open_issues_count":203,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":268,"open_issues":203,"watchers":1486,"default_branch":"master"}},"base":{"label":"confluentinc:4.1.x","ref":"4.1.x","sha":"092f28c7bf81f9f6cd6fa28134f4a067f63eb83d","user":{"login":"confluentinc","id":9439498,"avatar_url":"https://avatars0.githubusercontent.com/u/9439498?v=4","gravatar_id":"","url":"https://api.github.com/users/confluentinc","html_url":"https://github.com/confluentinc","followers_url":"https://api.github.com/users/confluentinc/followers","following_url":"https://api.github.com/users/confluentinc/following{/other_user}","gists_url":"https://api.github.com/users/confluentinc/gists{/gist_id}","starred_url":"https://api.github.com/users/confluentinc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/confluentinc/subscriptions","organizations_url":"https://api.github.com/users/confluentinc/orgs","repos_url":"https://api.github.com/users/confluentinc/repos","events_url":"https://api.github.com/users/confluentinc/events{/privacy}","received_events_url":"https://api.github.com/users/confluentinc/received_events","type":"Organization","site_admin":false},"repo":{"id":69400326,"name":"ksql","full_name":"confluentinc/ksql","owner":{"login":"confluentinc","id":9439498,"avatar_url":"https://avatars0.githubusercontent.com/u/9439498?v=4","gravatar_id":"","url":"https://api.github.com/users/confluentinc","html_url":"https://github.com/confluentinc","followers_url":"https://api.github.com/users/confluentinc/followers","following_url":"https://api.github.com/users/confluentinc/following{/other_user}","gists_url":"https://api.github.com/users/confluentinc/gists{/gist_id}","starred_url":"https://api.github.com/users/confluentinc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/confluentinc/subscriptions","organizations_url":"https://api.github.com/users/confluentinc/orgs","repos_url":"https://api.github.com/users/confluentinc/repos","events_url":"https://api.github.com/users/confluentinc/events{/privacy}","received_events_url":"https://api.github.com/users/confluentinc/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/confluentinc/ksql","description":"KSQL - the Streaming SQL Engine for Apache Kafka ","fork":false,"url":"https://api.github.com/repos/confluentinc/ksql","forks_url":"https://api.github.com/repos/confluentinc/ksql/forks","keys_url":"https://api.github.com/repos/confluentinc/ksql/keys{/key_id}","collaborators_url":"https://api.github.com/repos/confluentinc/ksql/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/confluentinc/ksql/teams","hooks_url":"https://api.github.com/repos/confluentinc/ksql/hooks","issue_events_url":"https://api.github.com/repos/confluentinc/ksql/issues/events{/number}","events_url":"https://api.github.com/repos/confluentinc/ksql/events","assignees_url":"https://api.github.com/repos/confluentinc/ksql/assignees{/user}","branches_url":"https://api.github.com/repos/confluentinc/ksql/branches{/branch}","tags_url":"https://api.github.com/repos/confluentinc/ksql/tags","blobs_url":"https://api.github.com/repos/confluentinc/ksql/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/confluentinc/ksql/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/confluentinc/ksql/git/refs{/sha}","trees_url":"https://api.github.com/repos/confluentinc/ksql/git/trees{/sha}","statuses_url":"https://api.github.com/repos/confluentinc/ksql/statuses/{sha}","languages_url":"https://api.github.com/repos/confluentinc/ksql/languages","stargazers_url":"https://api.github.com/repos/confluentinc/ksql/stargazers","contributors_url":"https://api.github.com/repos/confluentinc/ksql/contributors","subscribers_url":"https://api.github.com/repos/confluentinc/ksql/subscribers","subscription_url":"https://api.github.com/repos/confluentinc/ksql/subscription","commits_url":"https://api.github.com/repos/confluentinc/ksql/commits{/sha}","git_commits_url":"https://api.github.com/repos/confluentinc/ksql/git/commits{/sha}","comments_url":"https://api.github.com/repos/confluentinc/ksql/comments{/number}","issue_comment_url":"https://api.github.com/repos/confluentinc/ksql/issues/comments{/number}","contents_url":"https://api.github.com/repos/confluentinc/ksql/contents/{+path}","compare_url":"https://api.github.com/repos/confluentinc/ksql/compare/{base}...{head}","merges_url":"https://api.github.com/repos/confluentinc/ksql/merges","archive_url":"https://api.github.com/repos/confluentinc/ksql/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/confluentinc/ksql/downloads","issues_url":"https://api.github.com/repos/confluentinc/ksql/issues{/number}","pulls_url":"https://api.github.com/repos/confluentinc/ksql/pulls{/number}","milestones_url":"https://api.github.com/repos/confluentinc/ksql/milestones{/number}","notifications_url":"https://api.github.com/repos/confluentinc/ksql/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/confluentinc/ksql/labels{/name}","releases_url":"https://api.github.com/repos/confluentinc/ksql/releases{/id}","deployments_url":"https://api.github.com/repos/confluentinc/ksql/deployments","created_at":"2016-09-27T21:30:15Z","updated_at":"2018-03-21T19:05:40Z","pushed_at":"2018-03-21T22:29:47Z","git_url":"git://github.com/confluentinc/ksql.git","ssh_url":"git@github.com:confluentinc/ksql.git","clone_url":"https://github.com/confluentinc/ksql.git","svn_url":"https://github.com/confluentinc/ksql","homepage":"","size":6534,"stargazers_count":1486,"watchers_count":1486,"language":"Java","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":268,"mirror_url":null,"archived":false,"open_issues_count":203,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":268,"open_issues":203,"watchers":1486,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/974"},"html":{"href":"https://github.com/confluentinc/ksql/pull/974"},"issue":{"href":"https://api.github.com/repos/confluentinc/ksql/issues/974"},"comments":{"href":"https://api.github.com/repos/confluentinc/ksql/issues/974/comments"},"review_comments":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/974/comments"},"review_comment":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/confluentinc/ksql/pulls/974/commits"},"statuses":{"href":"https://api.github.com/repos/confluentinc/ksql/statuses/896a5a8fb9aac31767a1e3e2b92ede31306ee946"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"apurvam"}}