WARNING: Version 1.4 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« memcached Node »

› ›

Network Settings

edit

Network Settings

edit

There are several modules within a Node that use network based configuration, for example, the transport and http modules. Node level network settings allows to set common settings that will be shared among all network based modules (unless explicitly overridden in each module).

The network.bind_host setting allows to control the host different network components will bind on. By default, the bind host will be anyLocalAddress (typically 0.0.0.0 or ::0).

The network.publish_host setting allows to control the host the node will publish itself within the cluster so other nodes will be able to connect to it. Of course, this can’t be the anyLocalAddress, and by default, it will be the first non loopback address (if possible), or the local address.

The network.host setting is a simple setting to automatically set both network.bind_host and network.publish_host to the same host value.

Both settings allows to be configured with either explicit host address or host name. The settings also accept logical setting values explained in the following table:

Logical Host Setting Value	Description
`_local_`	Will be resolved to the local ip address.
`_non_loopback_`	The first non loopback address.
`_non_loopback:ipv4_`	The first non loopback IPv4 address.
`_non_loopback:ipv6_`	The first non loopback IPv6 address.
`_[networkInterface]_`	Resolves to the ip address of the provided network interface. For example `_en0_`.
`_[networkInterface]:ipv4_`	Resolves to the ipv4 address of the provided network interface. For example `_en0:ipv4_`.
`_[networkInterface]:ipv6_`	Resolves to the ipv6 address of the provided network interface. For example `_en0:ipv6_`.

When the cloud-aws plugin is installed, the following are also allowed as valid network host settings:

EC2 Host Value	Description
`_ec2:privateIpv4_`	The private IP address (ipv4) of the machine.
`_ec2:privateDns_`	The private host of the machine.
`_ec2:publicIpv4_`	The public IP address (ipv4) of the machine.
`_ec2:publicDns_`	The public host of the machine.
`_ec2_`	Less verbose option for the private ip address.
`_ec2:privateIp_`	Less verbose option for the private ip address.
`_ec2:publicIp_`	Less verbose option for the public ip address.

TCP Settings

edit

Any component that uses TCP (like the HTTP, Transport and Memcached) share the following allowed settings:

Setting	Description
`network.tcp.no_delay`	Enable or disable tcp no delay setting. Defaults to `true`. [1.4.0.Beta1] Added in 1.4.0.Beta1. Can be set to `default` to not be set at all.
`network.tcp.keep_alive`	Enable or disable tcp keep alive. Defaults to `true`. [1.4.0.Beta1] Added in 1.4.0.Beta1. Can be set to `default` to not be set at all .
`network.tcp.reuse_address`	Should an address be reused or not. Defaults to `true` on non-windows machines.
`network.tcp.send_buffer_size`	The size of the tcp send buffer size (in size setting format). By default not explicitly set.
`network.tcp.receive_buffer_size`	The size of the tcp receive buffer size (in size setting format). By default not explicitly set.

« memcached Node »