This is an automated email from the ASF dual-hosted git repository.
ptupitsyn pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/ignite.git
The following commit(s) were added to refs/heads/master by this push:
new 24050d9df69 IGNITE-24906 Improve client cluster discovery docs (#12549)
24050d9df69 is described below
commit 24050d9df69272a32108d75f2184252c9d40f2c0
Author: Pavel Tupitsyn <[email protected]>
AuthorDate: Wed Dec 3 14:17:07 2025 +0200
IGNITE-24906 Improve client cluster discovery docs (#12549)
---
docs/_docs/thin-clients/dotnet-thin-client.adoc | 16 ++++++++++++++-
docs/_docs/thin-clients/java-thin-client.adoc | 27 +++++++++++++++++++++++++
2 files changed, 42 insertions(+), 1 deletion(-)
diff --git a/docs/_docs/thin-clients/dotnet-thin-client.adoc
b/docs/_docs/thin-clients/dotnet-thin-client.adoc
index b326dd3a490..50ae0855c53 100644
--- a/docs/_docs/thin-clients/dotnet-thin-client.adoc
+++ b/docs/_docs/thin-clients/dotnet-thin-client.adoc
@@ -59,11 +59,25 @@ include::{sourceCodeFile}[tag=discovery,indent=0]
[WARNING]
====
-[discrete]
Server discovery may not work when servers are behind a NAT server or a proxy.
Server nodes provide their addresses and ports to the client, but when the
client is in a different subnet, those addresses won't work.
====
+==== Host Names and TLS
+
+By default, server nodes advertise their IP addresses during discovery.
+If clients must connect using host names (for example, when TLS is enabled and
certificates contain host names),
+configure each server node to advertise its host name by setting
`IgniteConfiguration.Localhost` on the *server* side.
+
+[source, csharp]
+----
+var cfg = new IgniteConfiguration
+{
+ Localhost = "my-server1-hostname",
+ // ...
+};
+----
+
[[partition_awareness]]
== Partition Awareness
diff --git a/docs/_docs/thin-clients/java-thin-client.adoc
b/docs/_docs/thin-clients/java-thin-client.adoc
index dcc6ac5a5ac..403cdf4d10a 100644
--- a/docs/_docs/thin-clients/java-thin-client.adoc
+++ b/docs/_docs/thin-clients/java-thin-client.adoc
@@ -75,6 +75,33 @@ include::{sourceCodeFile}[tag=connect-to-many-nodes,indent=0]
Note that the code above provides a failover mechanism in case of server node
failures. Refer to the <<Handling Node Failures>> section for more information.
+[[discovery]]
+=== Automatic Server Node Discovery
+
+Thin client can discover server nodes in the cluster automatically.
+This behavior is enabled when `ClientConfiguration.clusterDiscoveryEnabled` is
enabled (`true` by default).
+
+Server discovery is an asynchronous process - it happens in the background.
+Additionally, thin client receives topology updates only when it performs some
operations (to minimize server load and network traffic from idle connections).
+
+[WARNING]
+====
+Server discovery may not work when servers are behind a NAT server or a proxy.
+Server nodes provide their addresses and ports to the client, but when the
client is in a different subnet, those addresses won't work.
+====
+
+==== Host Names and TLS
+
+By default, server nodes advertise their IP addresses during discovery.
+If clients must connect using host names (for example, when TLS is enabled and
certificates contain host names),
+configure each server node to advertise its host name by setting
`IgniteConfiguration#localHost` on the *server* side.
+
+[source, java]
+----
+IgniteConfiguration cfg = new IgniteConfiguration()
+ .setLocalHost("my-server1-hostname");
+----
+
== Partition Awareness [partition_awareness]
include::includes/partition-awareness.adoc[]
