You should list system primaries in your endpoints (#2016)

Co-authored-by: NataliaIvakina <[email protected]>

Author: jackwaudby

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, ensure that the endpoint for each server hosting the `system` database in primary mode is included.
+====
+
 [[clustering-discovery-list]]
 === Discovery using a list of server addresses
 

modules/ROOT/pages/configuration/configuration-settings.adoc

@@ -365,7 +365,6 @@ 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.
 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,14 +381,19 @@ 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.
 |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
 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`