{"action":"created","comment":{"url":"https://api.github.com/repos/elastic/elasticsearch/pulls/comments/33896144","id":33896144,"diff_hunk":"@@ -0,0 +1,229 @@\n+[[plugin-management]]\n+== Plugin Management\n+\n+The `plugin` script is used to install, list, and remove plugins. It is\n+located in the `$ES_HOME/bin` directory by default but it may be in a\n+{ref}/setup-dir-layout.html[different location] if you installed Elasticsearch\n+with an RPM or deb package.\n+\n+Run the following command to get usage instructions:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin -h\n+-----------------------------------\n+\n+[[installation]]\n+=== Installing Plugins\n+\n+The documentation for each plugin usually includes specific installation\n+instructions for that plugin, but below we document the various available\n+options:\n+\n+[float]\n+==== Core Elasticsearch plugins\n+\n+Core Elasticsearch plugins can be installed as follows:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --install [plugin_name]\n+-----------------------------------\n+\n+For instance, to install the core <<analysis-icu,ICU plugin>>, just run the\n+following command:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --install analysis-icu\n+-----------------------------------\n+\n+This command will install the version of the plugin that matches your\n+Elasticsearch version.\n+\n+[float]\n+==== Community and non-core plugins\n+\n+Non-core plugins provided by Elasticsearch, or plugins provided by the\n+community, can be installed from `download.elastic.co`, from Maven (Central\n+and Sonatype), or from GitHub.  In this case, the command is as follows:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --install [org]/[user|component]/[version]\n+-----------------------------------\n+\n+For instance, to install the https://github.com/lmenezes/elasticsearch-kopf[Kopf]\n+plugin from GitHub, run one of the following commands:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --install lmenezes/elasticsearch-kopf <1>\n+bin/plugin --install lmenezes/elasticsearch-kopf/1.x <2>\n+-----------------------------------\n+<1> Installs the latest version from GitHub.\n+<2> Installs the 1.x version from GitHub.\n+\n+When installing from Maven Central/Sonatype, `[org]` should be replaced by\n+the artifact `groupId`, and `[user|component]` by the `artifactId`.  For\n+instance, to install the\n+https://github.com/elastic/elasticsearch-mapper-attachments[mapper attachment]\n+plugin from Sonatype, run:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --install org.elasticsearch/elasticsearch-mapper-attachments/2.6.0 <1>\n+-----------------------------------\n+<1> When installing from `download.elastic.co` or from Maven Central/Sonatype, the\n+    version is required.\n+\n+[float]\n+==== Custom URL or file system\n+\n+A plugin can also be downloaded directly from a custom location by specifying the URL:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --url [url] --install [plugin-name] <1>\n+-----------------------------------\n+<1> Both the URL and the plugin name must be specified.\n+\n+For instance, to install a plugin from your local file system, you could run:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --url file:///path/to/plugin.zip --install my_plugin\n+-----------------------------------\n+\n+.Installation process\n+*************************************\n+\n+The plugin installer tries to download a Zip file from a custom URL (if\n+specified), from `download.elastic.co`, Maven Central, Sonatype, or GitHub.\n+If successful, it unzips the plugin into the `plugins/` directory, usually\n+located under `$ES_HOME`.\n+\n+If a plugin contains a `bin/` or `config/` directory, their contents are moved\n+to the `$ES_HOME/bin` and `$ES_HOME/config` directories respectively.\n+\n+If any other non-JAR files are present and the plugin doesn't already contain\n+a `_site/` directory, that directory is created and all non JAR files are moved\n+into it.\n+\n+*************************************\n+\n+\n+[[listing-removing]]\n+=== Listing and Removing Installed Plugins\n+\n+[float]\n+==== Listing plugins\n+\n+A list of the currently loaded plugins can be retrieved with the `--list` option:\n+\n+[source,shell]\n+-----------------------------------\n+bin/plugin --list","path":"docs/plugins/plugin-script.asciidoc","position":126,"original_position":126,"commit_id":"395b1924f0621ec82c37c0dabd9abb298f399934","original_commit_id":"395b1924f0621ec82c37c0dabd9abb298f399934","user":{"login":"dadoonet","id":274222,"avatar_url":"https://avatars.githubusercontent.com/u/274222?v=3","gravatar_id":"","url":"https://api.github.com/users/dadoonet","html_url":"https://github.com/dadoonet","followers_url":"https://api.github.com/users/dadoonet/followers","following_url":"https://api.github.com/users/dadoonet/following{/other_user}","gists_url":"https://api.github.com/users/dadoonet/gists{/gist_id}","starred_url":"https://api.github.com/users/dadoonet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dadoonet/subscriptions","organizations_url":"https://api.github.com/users/dadoonet/orgs","repos_url":"https://api.github.com/users/dadoonet/repos","events_url":"https://api.github.com/users/dadoonet/events{/privacy}","received_events_url":"https://api.github.com/users/dadoonet/received_events","type":"User","site_admin":false},"body":"Unfortunately current version of the plugin manager does not support `list` command but only `--list` or `-l`. @clintongormley do you want me to open a small PR adding support for `list` so we will be consistent with `install` and `remove`?","created_at":"2015-07-05T16:22:41Z","updated_at":"2015-07-05T16:22:41Z","html_url":"https://github.com/elastic/elasticsearch/pull/12040#discussion_r33896144","pull_request_url":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040","_links":{"self":{"href":"https://api.github.com/repos/elastic/elasticsearch/pulls/comments/33896144"},"html":{"href":"https://github.com/elastic/elasticsearch/pull/12040#discussion_r33896144"},"pull_request":{"href":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040"}}},"pull_request":{"url":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040","id":39222735,"html_url":"https://github.com/elastic/elasticsearch/pull/12040","diff_url":"https://github.com/elastic/elasticsearch/pull/12040.diff","patch_url":"https://github.com/elastic/elasticsearch/pull/12040.patch","issue_url":"https://api.github.com/repos/elastic/elasticsearch/issues/12040","number":12040,"state":"open","locked":false,"title":"Docs: Prepare plugin and integration docs for 2.0","user":{"login":"clintongormley","id":56599,"avatar_url":"https://avatars.githubusercontent.com/u/56599?v=3","gravatar_id":"","url":"https://api.github.com/users/clintongormley","html_url":"https://github.com/clintongormley","followers_url":"https://api.github.com/users/clintongormley/followers","following_url":"https://api.github.com/users/clintongormley/following{/other_user}","gists_url":"https://api.github.com/users/clintongormley/gists{/gist_id}","starred_url":"https://api.github.com/users/clintongormley/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/clintongormley/subscriptions","organizations_url":"https://api.github.com/users/clintongormley/orgs","repos_url":"https://api.github.com/users/clintongormley/repos","events_url":"https://api.github.com/users/clintongormley/events{/privacy}","received_events_url":"https://api.github.com/users/clintongormley/received_events","type":"User","site_admin":false},"body":"* Centralised plugin docs in docs/plugins/\r\n* Moved integrations into same docs\r\n* Moved community clients into the clients section of the docs\r\n* Removed docs/community\r\n\r\nCloses #11734\r\nCloses #11724\r\nCloses #11636\r\nCloses #11635\r\nCloses #11632\r\nCloses #11630","created_at":"2015-07-05T15:51:56Z","updated_at":"2015-07-05T16:22:41Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1faad967bb6ea9836124519133d210a93f4de4ca","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040/commits","review_comments_url":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040/comments","review_comment_url":"https://api.github.com/repos/elastic/elasticsearch/pulls/comments{/number}","comments_url":"https://api.github.com/repos/elastic/elasticsearch/issues/12040/comments","statuses_url":"https://api.github.com/repos/elastic/elasticsearch/statuses/395b1924f0621ec82c37c0dabd9abb298f399934","head":{"label":"clintongormley:plugin_docs","ref":"plugin_docs","sha":"395b1924f0621ec82c37c0dabd9abb298f399934","user":{"login":"clintongormley","id":56599,"avatar_url":"https://avatars.githubusercontent.com/u/56599?v=3","gravatar_id":"","url":"https://api.github.com/users/clintongormley","html_url":"https://github.com/clintongormley","followers_url":"https://api.github.com/users/clintongormley/followers","following_url":"https://api.github.com/users/clintongormley/following{/other_user}","gists_url":"https://api.github.com/users/clintongormley/gists{/gist_id}","starred_url":"https://api.github.com/users/clintongormley/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/clintongormley/subscriptions","organizations_url":"https://api.github.com/users/clintongormley/orgs","repos_url":"https://api.github.com/users/clintongormley/repos","events_url":"https://api.github.com/users/clintongormley/events{/privacy}","received_events_url":"https://api.github.com/users/clintongormley/received_events","type":"User","site_admin":false},"repo":{"id":1841736,"name":"elasticsearch","full_name":"clintongormley/elasticsearch","owner":{"login":"clintongormley","id":56599,"avatar_url":"https://avatars.githubusercontent.com/u/56599?v=3","gravatar_id":"","url":"https://api.github.com/users/clintongormley","html_url":"https://github.com/clintongormley","followers_url":"https://api.github.com/users/clintongormley/followers","following_url":"https://api.github.com/users/clintongormley/following{/other_user}","gists_url":"https://api.github.com/users/clintongormley/gists{/gist_id}","starred_url":"https://api.github.com/users/clintongormley/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/clintongormley/subscriptions","organizations_url":"https://api.github.com/users/clintongormley/orgs","repos_url":"https://api.github.com/users/clintongormley/repos","events_url":"https://api.github.com/users/clintongormley/events{/privacy}","received_events_url":"https://api.github.com/users/clintongormley/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/clintongormley/elasticsearch","description":"Open Source, Distributed, RESTful Search Engine","fork":true,"url":"https://api.github.com/repos/clintongormley/elasticsearch","forks_url":"https://api.github.com/repos/clintongormley/elasticsearch/forks","keys_url":"https://api.github.com/repos/clintongormley/elasticsearch/keys{/key_id}","collaborators_url":"https://api.github.com/repos/clintongormley/elasticsearch/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/clintongormley/elasticsearch/teams","hooks_url":"https://api.github.com/repos/clintongormley/elasticsearch/hooks","issue_events_url":"https://api.github.com/repos/clintongormley/elasticsearch/issues/events{/number}","events_url":"https://api.github.com/repos/clintongormley/elasticsearch/events","assignees_url":"https://api.github.com/repos/clintongormley/elasticsearch/assignees{/user}","branches_url":"https://api.github.com/repos/clintongormley/elasticsearch/branches{/branch}","tags_url":"https://api.github.com/repos/clintongormley/elasticsearch/tags","blobs_url":"https://api.github.com/repos/clintongormley/elasticsearch/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/clintongormley/elasticsearch/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/clintongormley/elasticsearch/git/refs{/sha}","trees_url":"https://api.github.com/repos/clintongormley/elasticsearch/git/trees{/sha}","statuses_url":"https://api.github.com/repos/clintongormley/elasticsearch/statuses/{sha}","languages_url":"https://api.github.com/repos/clintongormley/elasticsearch/languages","stargazers_url":"https://api.github.com/repos/clintongormley/elasticsearch/stargazers","contributors_url":"https://api.github.com/repos/clintongormley/elasticsearch/contributors","subscribers_url":"https://api.github.com/repos/clintongormley/elasticsearch/subscribers","subscription_url":"https://api.github.com/repos/clintongormley/elasticsearch/subscription","commits_url":"https://api.github.com/repos/clintongormley/elasticsearch/commits{/sha}","git_commits_url":"https://api.github.com/repos/clintongormley/elasticsearch/git/commits{/sha}","comments_url":"https://api.github.com/repos/clintongormley/elasticsearch/comments{/number}","issue_comment_url":"https://api.github.com/repos/clintongormley/elasticsearch/issues/comments{/number}","contents_url":"https://api.github.com/repos/clintongormley/elasticsearch/contents/{+path}","compare_url":"https://api.github.com/repos/clintongormley/elasticsearch/compare/{base}...{head}","merges_url":"https://api.github.com/repos/clintongormley/elasticsearch/merges","archive_url":"https://api.github.com/repos/clintongormley/elasticsearch/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/clintongormley/elasticsearch/downloads","issues_url":"https://api.github.com/repos/clintongormley/elasticsearch/issues{/number}","pulls_url":"https://api.github.com/repos/clintongormley/elasticsearch/pulls{/number}","milestones_url":"https://api.github.com/repos/clintongormley/elasticsearch/milestones{/number}","notifications_url":"https://api.github.com/repos/clintongormley/elasticsearch/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/clintongormley/elasticsearch/labels{/name}","releases_url":"https://api.github.com/repos/clintongormley/elasticsearch/releases{/id}","created_at":"2011-06-03T09:53:19Z","updated_at":"2015-03-10T00:44:50Z","pushed_at":"2015-07-05T15:51:13Z","git_url":"git://github.com/clintongormley/elasticsearch.git","ssh_url":"git@github.com:clintongormley/elasticsearch.git","clone_url":"https://github.com/clintongormley/elasticsearch.git","svn_url":"https://github.com/clintongormley/elasticsearch","homepage":"http://elasticsearch.org","size":113474,"stargazers_count":1,"watchers_count":1,"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":1,"default_branch":"master"}},"base":{"label":"elastic:master","ref":"master","sha":"d74eac94f228a1b9f819cff79660d86d9faf1fb3","user":{"login":"elastic","id":6764390,"avatar_url":"https://avatars.githubusercontent.com/u/6764390?v=3","gravatar_id":"","url":"https://api.github.com/users/elastic","html_url":"https://github.com/elastic","followers_url":"https://api.github.com/users/elastic/followers","following_url":"https://api.github.com/users/elastic/following{/other_user}","gists_url":"https://api.github.com/users/elastic/gists{/gist_id}","starred_url":"https://api.github.com/users/elastic/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elastic/subscriptions","organizations_url":"https://api.github.com/users/elastic/orgs","repos_url":"https://api.github.com/users/elastic/repos","events_url":"https://api.github.com/users/elastic/events{/privacy}","received_events_url":"https://api.github.com/users/elastic/received_events","type":"Organization","site_admin":false},"repo":{"id":507775,"name":"elasticsearch","full_name":"elastic/elasticsearch","owner":{"login":"elastic","id":6764390,"avatar_url":"https://avatars.githubusercontent.com/u/6764390?v=3","gravatar_id":"","url":"https://api.github.com/users/elastic","html_url":"https://github.com/elastic","followers_url":"https://api.github.com/users/elastic/followers","following_url":"https://api.github.com/users/elastic/following{/other_user}","gists_url":"https://api.github.com/users/elastic/gists{/gist_id}","starred_url":"https://api.github.com/users/elastic/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elastic/subscriptions","organizations_url":"https://api.github.com/users/elastic/orgs","repos_url":"https://api.github.com/users/elastic/repos","events_url":"https://api.github.com/users/elastic/events{/privacy}","received_events_url":"https://api.github.com/users/elastic/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/elastic/elasticsearch","description":"Open Source, Distributed, RESTful Search Engine","fork":false,"url":"https://api.github.com/repos/elastic/elasticsearch","forks_url":"https://api.github.com/repos/elastic/elasticsearch/forks","keys_url":"https://api.github.com/repos/elastic/elasticsearch/keys{/key_id}","collaborators_url":"https://api.github.com/repos/elastic/elasticsearch/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/elastic/elasticsearch/teams","hooks_url":"https://api.github.com/repos/elastic/elasticsearch/hooks","issue_events_url":"https://api.github.com/repos/elastic/elasticsearch/issues/events{/number}","events_url":"https://api.github.com/repos/elastic/elasticsearch/events","assignees_url":"https://api.github.com/repos/elastic/elasticsearch/assignees{/user}","branches_url":"https://api.github.com/repos/elastic/elasticsearch/branches{/branch}","tags_url":"https://api.github.com/repos/elastic/elasticsearch/tags","blobs_url":"https://api.github.com/repos/elastic/elasticsearch/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/elastic/elasticsearch/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/elastic/elasticsearch/git/refs{/sha}","trees_url":"https://api.github.com/repos/elastic/elasticsearch/git/trees{/sha}","statuses_url":"https://api.github.com/repos/elastic/elasticsearch/statuses/{sha}","languages_url":"https://api.github.com/repos/elastic/elasticsearch/languages","stargazers_url":"https://api.github.com/repos/elastic/elasticsearch/stargazers","contributors_url":"https://api.github.com/repos/elastic/elasticsearch/contributors","subscribers_url":"https://api.github.com/repos/elastic/elasticsearch/subscribers","subscription_url":"https://api.github.com/repos/elastic/elasticsearch/subscription","commits_url":"https://api.github.com/repos/elastic/elasticsearch/commits{/sha}","git_commits_url":"https://api.github.com/repos/elastic/elasticsearch/git/commits{/sha}","comments_url":"https://api.github.com/repos/elastic/elasticsearch/comments{/number}","issue_comment_url":"https://api.github.com/repos/elastic/elasticsearch/issues/comments{/number}","contents_url":"https://api.github.com/repos/elastic/elasticsearch/contents/{+path}","compare_url":"https://api.github.com/repos/elastic/elasticsearch/compare/{base}...{head}","merges_url":"https://api.github.com/repos/elastic/elasticsearch/merges","archive_url":"https://api.github.com/repos/elastic/elasticsearch/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/elastic/elasticsearch/downloads","issues_url":"https://api.github.com/repos/elastic/elasticsearch/issues{/number}","pulls_url":"https://api.github.com/repos/elastic/elasticsearch/pulls{/number}","milestones_url":"https://api.github.com/repos/elastic/elasticsearch/milestones{/number}","notifications_url":"https://api.github.com/repos/elastic/elasticsearch/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/elastic/elasticsearch/labels{/name}","releases_url":"https://api.github.com/repos/elastic/elasticsearch/releases{/id}","created_at":"2010-02-08T13:20:56Z","updated_at":"2015-07-05T15:37:06Z","pushed_at":"2015-07-05T16:21:05Z","git_url":"git://github.com/elastic/elasticsearch.git","ssh_url":"git@github.com:elastic/elasticsearch.git","clone_url":"https://github.com/elastic/elasticsearch.git","svn_url":"https://github.com/elastic/elasticsearch","homepage":"https://www.elastic.co/products/elasticsearch","size":1905656,"stargazers_count":11869,"watchers_count":11869,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":3762,"mirror_url":null,"open_issues_count":1151,"forks":3762,"open_issues":1151,"watchers":11869,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040"},"html":{"href":"https://github.com/elastic/elasticsearch/pull/12040"},"issue":{"href":"https://api.github.com/repos/elastic/elasticsearch/issues/12040"},"comments":{"href":"https://api.github.com/repos/elastic/elasticsearch/issues/12040/comments"},"review_comments":{"href":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040/comments"},"review_comment":{"href":"https://api.github.com/repos/elastic/elasticsearch/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/elastic/elasticsearch/pulls/12040/commits"},"statuses":{"href":"https://api.github.com/repos/elastic/elasticsearch/statuses/395b1924f0621ec82c37c0dabd9abb298f399934"}}}}