Add doc note regarding explicit publish host

This commit adds a note to the docs regarding explicilty setting a
publish host if the network.host setting results in multiple bind
addresses.

Relates #25496
This commit is contained in:
Jason Tedor 2017-06-30 12:59:02 -04:00 committed by GitHub
parent 1dd28808d5
commit 1b602477ae
1 changed files with 8 additions and 6 deletions

View File

@ -116,12 +116,14 @@ two network cards, or a site-local address and a local address. Defaults to
`network.publish_host`::
The publish host is the single interface that the node advertises to other
nodes in the cluster, so that those nodes can connect to it. Currently an
elasticsearch node may be bound to multiple addresses, but only publishes one.
If not specified, this defaults to the ``best'' address from
`network.host`, sorted by IPv4/IPv6 stack preference, then by
reachability.
The publish host is the single interface that the node advertises to other nodes
in the cluster, so that those nodes can connect to it. Currently an
Elasticsearch node may be bound to multiple addresses, but only publishes one.
If not specified, this defaults to the ``best'' address from `network.host`,
sorted by IPv4/IPv6 stack preference, then by reachability. If you set a
`network.host` that results in multiple bind addresses yet rely on a specific
address for node-to-node communication, you should explicitly set
`network.publish_host`.
Both of the above settings can be configured just like `network.host` -- they
accept IP addresses, host names, and