github-mirrors/elasticsearch
1
0
Fork 0
mirror of https://github.com/elastic/elasticsearch.git synced 2025-06-28 17:34:17 -04:00
Code Issues Projects Releases Packages Wiki Activity

Clarify use of special values for publish addresses (#114551)

Browse source 
Special values like `0.0.0.0` may resolve to multiple IP addresses just
like hostnames, so the same considerations apply when using such values
as a publish address. This commit spells this case out in the docs and
cleans up the nearby wording a little.
This commit is contained in:
David Turner 2024-10-14 16:39:00 +01:00 • committed by GitHub
parent b0aa39fa67
commit 9eab11c45b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 18 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

25
docs/reference/modules/network.asciidoc
View file

@ -153,23 +153,34 @@ The only requirements are that each node must be:
* Accessible at its transport publish address by all other nodes in its
cluster, and by any remote clusters that will discover it using
<<sniff-mode>>.
<<sniff-mode,sniff mode>>.
Each node must have its own distinct publish address.
If you specify the transport publish address using a hostname then {es} will
resolve this hostname to an IP address once during startup, and other nodes
will use the resulting IP address instead of resolving the name again
themselves. To avoid confusion, use a hostname which resolves to the node's
address in all network locations.
themselves. You must use a hostname such that all of the addresses to which it
resolves are addresses at which the node is accessible from all other nodes. To
avoid confusion, it is simplest to use a hostname which resolves to a single
address.
If you specify the transport publish address using a
<<network-interface-values,special value>> then {es} will resolve this value to
a single IP address during startup, and other nodes will use the resulting IP
address instead of resolving the value again themselves. You must use a value
such that all of the addresses to which it resolves are addresses at which the
node is accessible from all other nodes. To avoid confusion, it is simplest to
use a value which resolves to a single address. It is usually a mistake to use
`0.0.0.0` as a publish address on hosts with more than one network interface.
===== Using a single address
The most common configuration is for {es} to bind to a single address at which
it is accessible to clients and other nodes. In this configuration you should
just set `network.host` to that address. You should not separately set any bind
or publish addresses, nor should you separately configure the addresses for the
HTTP or transport interfaces.
it is accessible to clients and other nodes. To use this configuration, set
only `network.host` to the desired address. Do not separately set any bind or
publish addresses. Do not separately specify the addresses for the HTTP or
transport interfaces.
===== Using multiple addresses