Docs: Added offline install link for discovery-file plugin

Closes #21696
This commit is contained in:
Clinton Gormley 2016-11-21 11:47:48 +01:00
parent 6122b84eba
commit 496afbbda5
1 changed files with 17 additions and 13 deletions

View File

@ -1,7 +1,7 @@
[[discovery-file]] [[discovery-file]]
=== File-Based Discovery Plugin === File-Based Discovery Plugin
The file-based discovery plugin uses a list of hosts/ports in a `unicast_hosts.txt` file The file-based discovery plugin uses a list of hosts/ports in a `unicast_hosts.txt` file
in the `config/discovery-file` directory for unicast discovery. in the `config/discovery-file` directory for unicast discovery.
[[discovery-file-install]] [[discovery-file-install]]
@ -20,6 +20,10 @@ be restarted after installation. Note that installing the plugin will add a
`discovery-file` directory to the `config` folder, and a default `unicast_hosts.txt` `discovery-file` directory to the `config` folder, and a default `unicast_hosts.txt`
file that must be edited with the correct unicast hosts list before starting the node. file that must be edited with the correct unicast hosts list before starting the node.
This plugin can be downloaded for <<plugin-management-custom-url,offline install>> from
{plugin_url}/discovery-file/discovery-file-{version}.zip.
[[discovery-file-remove]] [[discovery-file-remove]]
[float] [float]
==== Removal ==== Removal
@ -37,7 +41,7 @@ The node must be stopped before removing the plugin.
[float] [float]
==== Using the file-based discovery plugin ==== Using the file-based discovery plugin
The file-based discovery plugin provides the ability to specify the The file-based discovery plugin provides the ability to specify the
unicast hosts list through a simple `unicast_hosts.txt` file that can unicast hosts list through a simple `unicast_hosts.txt` file that can
be dynamically updated at any time. To enable, add the following in `elasticsearch.yml`: be dynamically updated at any time. To enable, add the following in `elasticsearch.yml`:
@ -47,12 +51,12 @@ discovery.zen.hosts_provider: file
---- ----
This plugin simply provides a facility to supply the unicast hosts list for This plugin simply provides a facility to supply the unicast hosts list for
zen discovery through an external file that can be updated at any time by a side process. zen discovery through an external file that can be updated at any time by a side process.
For example, this gives a convenient mechanism for an Elasticsearch instance For example, this gives a convenient mechanism for an Elasticsearch instance
that is run in docker containers to be dynamically supplied a list of IP that is run in docker containers to be dynamically supplied a list of IP
addresses to connect to for zen discovery when those IP addresses may not be addresses to connect to for zen discovery when those IP addresses may not be
known at node startup. known at node startup.
Note that the file-based discovery plugin is meant to augment the unicast Note that the file-based discovery plugin is meant to augment the unicast
hosts list in `elasticsearch.yml` (if specified), not replace it. Therefore, hosts list in `elasticsearch.yml` (if specified), not replace it. Therefore,
@ -73,11 +77,11 @@ cannot start in the middle of a line).
[float] [float]
==== unicast_hosts.txt file format ==== unicast_hosts.txt file format
The format of the file is to specify one unicast host entry per line. The format of the file is to specify one unicast host entry per line.
Each unicast host entry consists of the host (host name or IP address) and Each unicast host entry consists of the host (host name or IP address) and
an optional transport port number. If the port number is specified, is must an optional transport port number. If the port number is specified, is must
come immediately after the host (on the same line) separated by a `:`. come immediately after the host (on the same line) separated by a `:`.
If the port number is not specified, a default value of 9300 is used. If the port number is not specified, a default value of 9300 is used.
For example, this is an example of `unicast_hosts.txt` for a cluster with For example, this is an example of `unicast_hosts.txt` for a cluster with
four nodes that participate in unicast discovery, some of which are not four nodes that participate in unicast discovery, some of which are not
@ -92,6 +96,6 @@ running on the default port:
[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:9301 [2001:0db8:85a3:0000:0000:8a2e:0370:7334]:9301
---------------------------------------------------------------- ----------------------------------------------------------------
Host names are allowed instead of IP addresses (similar to Host names are allowed instead of IP addresses (similar to
`discovery.zen.ping.unicast.hosts`), and IPv6 addresses must be `discovery.zen.ping.unicast.hosts`), and IPv6 addresses must be
specified in brackets with the port coming after the brackets. specified in brackets with the port coming after the brackets.