Skip to content

Commit 01121b9

Browse files
committed
Add paragraph on not using a load balancer (#36999)
The transport client validates that each time it connects to a particular address it reaches the same node. This means that it does not support a simple load balancer which exposes multiple nodes at a single address. This change calls this situation out explicitly in the docs. Relates #30141.
1 parent cf9b60a commit 01121b9

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

docs/java-api/client.asciidoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,12 @@ TransportClient client = new PreBuiltTransportClient(settings);
7979
//Add transport addresses and do something with the client...
8080
--------------------------------------------------
8181

82+
The transport client expects each transport address to resolve to a single
83+
Elasticsearch node. It forms multiple connections to each address and requires
84+
that each connection reaches the same node. This means that you should configure
85+
the client with the addresses of individual nodes in the cluster and should not
86+
use a load balancer that exposes multiple nodes at a single address.
87+
8288
The Transport client comes with a cluster sniffing feature which
8389
allows it to dynamically add new hosts and remove old ones.
8490
When sniffing is enabled, the transport client will connect to the nodes in its

0 commit comments

Comments
 (0)