From 8a9b1f878ecc498378c745dbc446af2064ffceb3 Mon Sep 17 00:00:00 2001 From: Jack Waudby Date: Wed, 18 Dec 2024 10:48:34 +0000 Subject: [PATCH 1/4] your endpoints should include the system database primaries --- modules/ROOT/pages/clustering/setup/discovery.adoc | 5 +++++ .../ROOT/pages/configuration/configuration-settings.adoc | 7 ++++--- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/clustering/setup/discovery.adoc b/modules/ROOT/pages/clustering/setup/discovery.adoc index e55f46656..bf9099cbf 100644 --- a/modules/ROOT/pages/clustering/setup/discovery.adoc +++ b/modules/ROOT/pages/clustering/setup/discovery.adoc @@ -34,6 +34,11 @@ The following sections describe the different methods for server discovery, conf Depending on the type of xref:configuration/configuration-settings.adoc#config_dbms.cluster.discovery.resolver_type[`dbms.cluster.discovery.resolver_type`] currently in use, the discovery service can use a list of server addresses, DNS records, or Kubernetes services to discover other servers in the cluster. The discovery configuration is used for initial discovery and to continuously exchange information about changes to the topology of the cluster. +[NOTE] +==== +Regardless of the method used to resolve the list of server addresses it should be ensured that the endpoint for each of the servers hosting the system database in primary mode are included. +==== + [[clustering-discovery-list]] === Discovery using a list of server addresses diff --git a/modules/ROOT/pages/configuration/configuration-settings.adoc b/modules/ROOT/pages/configuration/configuration-settings.adoc index b977c0976..2615a3ed0 100644 --- a/modules/ROOT/pages/configuration/configuration-settings.adoc +++ b/modules/ROOT/pages/configuration/configuration-settings.adoc @@ -365,7 +365,8 @@ m|+++10m+++ |=== |Description a|A comma-separated list of endpoints that a server should contact in order to discover other cluster members. -Typically, all cluster members, including the current server, must be specified in this list. +All cluster members hosting a system database primary must be specified in this list. +However it is typical that all cluster members, including the current server, are specified in this list. The setting configures the endpoints for Discovery service V1. |Valid values a|A comma-separated list where each element is a socket address in the format of `hostname:port`, `hostname`, or `:port`. @@ -382,8 +383,8 @@ m| |=== |Description a|A comma-separated list of endpoints that a server should contact in order to discover other cluster members. -Typically, all cluster members, including the current server, must be specified in this list. -The setting configures the endpoints for Discovery service V2. +All cluster members hosting a system database primary must be specified in this list. +However it is typical that all cluster members, including the current server, are specified in this list.The setting configures the endpoints for Discovery service V2. |Valid values a|A comma-separated list where each element is a socket address in the format of `hostname:port`, `hostname`, or `:port`. |Default value From 2e52ee42b0b7499342e1bf0f8ac8584f21364b6b Mon Sep 17 00:00:00 2001 From: Jack Waudby Date: Wed, 18 Dec 2024 10:50:32 +0000 Subject: [PATCH 2/4] new lines --- modules/ROOT/pages/configuration/configuration-settings.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/configuration/configuration-settings.adoc b/modules/ROOT/pages/configuration/configuration-settings.adoc index 2615a3ed0..46b285688 100644 --- a/modules/ROOT/pages/configuration/configuration-settings.adoc +++ b/modules/ROOT/pages/configuration/configuration-settings.adoc @@ -384,7 +384,8 @@ m| |Description a|A comma-separated list of endpoints that a server should contact in order to discover other cluster members. All cluster members hosting a system database primary must be specified in this list. -However it is typical that all cluster members, including the current server, are specified in this list.The setting configures the endpoints for Discovery service V2. +However it is typical that all cluster members, including the current server, are specified in this list. +The setting configures the endpoints for Discovery service V2. |Valid values a|A comma-separated list where each element is a socket address in the format of `hostname:port`, `hostname`, or `:port`. |Default value From 676ae971d039645665161887f55aab3846ace821 Mon Sep 17 00:00:00 2001 From: NataliaIvakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Wed, 8 Jan 2025 16:29:12 +0100 Subject: [PATCH 3/4] Update configuration-settings.adoc --- .../pages/configuration/configuration-settings.adoc | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/configuration/configuration-settings.adoc b/modules/ROOT/pages/configuration/configuration-settings.adoc index 46b285688..391ab5f20 100644 --- a/modules/ROOT/pages/configuration/configuration-settings.adoc +++ b/modules/ROOT/pages/configuration/configuration-settings.adoc @@ -365,8 +365,6 @@ m|+++10m+++ |=== |Description a|A comma-separated list of endpoints that a server should contact in order to discover other cluster members. -All cluster members hosting a system database primary must be specified in this list. -However it is typical that all cluster members, including the current server, are specified in this list. The setting configures the endpoints for Discovery service V1. |Valid values a|A comma-separated list where each element is a socket address in the format of `hostname:port`, `hostname`, or `:port`. @@ -383,8 +381,6 @@ m| |=== |Description a|A comma-separated list of endpoints that a server should contact in order to discover other cluster members. -All cluster members hosting a system database primary must be specified in this list. -However it is typical that all cluster members, including the current server, are specified in this list. The setting configures the endpoints for Discovery service V2. |Valid values a|A comma-separated list where each element is a socket address in the format of `hostname:port`, `hostname`, or `:port`. @@ -392,6 +388,12 @@ a|A comma-separated list where each element is a socket address in the format of m| |=== +[NOTE] +==== +`dbms.cluster.discovery.endpoints` and `dbms.cluster.discovery.v2.endpoints` must contain all cluster members hosting a `system` database in primary mode. +However, it is typical that all cluster members, including the current server, are specified in those lists. +==== + [role=label--enterprise-edition label--new-5.22 label--deprecated-5.26] [[config_dbms.cluster.discovery.version]] === `dbms.cluster.discovery.version` From 5f83ad2324b507514e649df7b90b312f6ccced69 Mon Sep 17 00:00:00 2001 From: NataliaIvakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Thu, 9 Jan 2025 11:41:55 +0100 Subject: [PATCH 4/4] Update modules/ROOT/pages/clustering/setup/discovery.adoc --- modules/ROOT/pages/clustering/setup/discovery.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/setup/discovery.adoc b/modules/ROOT/pages/clustering/setup/discovery.adoc index bf9099cbf..f3e978011 100644 --- a/modules/ROOT/pages/clustering/setup/discovery.adoc +++ b/modules/ROOT/pages/clustering/setup/discovery.adoc @@ -36,7 +36,7 @@ The discovery configuration is used for initial discovery and to continuously ex [NOTE] ==== -Regardless of the method used to resolve the list of server addresses it should be ensured that the endpoint for each of the servers hosting the system database in primary mode are included. +Regardless of the method used to resolve the list of server addresses, ensure that the endpoint for each server hosting the `system` database in primary mode is included. ==== [[clustering-discovery-list]]