Skip to content

Commit 01eda91

Browse files
committed
Remove notion of 2 discovery services
1 parent 54dc59f commit 01eda91

File tree

13 files changed

+55
-1346
lines changed

13 files changed

+55
-1346
lines changed

modules/ROOT/pages/clustering/disaster-recovery.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ Either:
9898
... Add completely new servers (see xref:clustering/servers.adoc#cluster-add-server[Add a server to the cluster]) or
9999
... Change the `system` database mode (`server.cluster.system_database_mode`) on the current `system` database's secondary servers to allow them to be primaries for the new `system` database.
100100
.. On each server, run `bin/neo4j-admin database load system --from-path=[path-to-dump] --overwrite-destination=true` to load the current `system` database dump.
101-
.. Ensure that `dbms.cluster.discovery.endpoints` are set correctly on all servers, see xref:clustering/setup/discovery.adoc[Cluster server discovery] for more information.
101+
.. Ensure that `dbms.cluster.endpoints` are set correctly on all servers, see xref:clustering/setup/discovery.adoc[Cluster server discovery] for more information.
102102
.. Return to step 1.
103103

104104

modules/ROOT/pages/clustering/settings.adoc

Lines changed: 7 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -45,62 +45,28 @@ Possible values are:
4545

4646
[.compact]
4747
`LIST`::
48-
Treats `dbms.cluster.discovery.endpoints` (or `dbms.cluster.discovery.v2.endpoints`, if you use discovery service v2 available as of Neo4j 5.23) as a list of addresses of servers to contact for discovery.
48+
Treats `dbms.cluster.endpoints` as a list of addresses of servers to contact for discovery.
4949
`DNS`::
50-
Treats `dbms.cluster.discovery.endpoints` (or `dbms.cluster.discovery.v2.endpoints`, if you use discovery service v2 available as of Neo4j 5.23) as a domain name to resolve via DNS.
51-
Expect DNS resolution to provide A records with hostnames or IP addresses of servers to contact for discovery, on the port specified by `dbms.cluster.discovery.endpoints`.
50+
Treats `dbms.cluster.endpoints` as a domain name to resolve via DNS.
51+
Expect DNS resolution to provide A records with hostnames or IP addresses of servers to contact for discovery, on the port specified by `dbms.cluster.endpoints`.
5252
`SRV`::
53-
Treats `dbms.cluster.discovery.endpoints` (or `dbms.cluster.discovery.v2.endpoints`, if you use discovery service v2 available as of Neo4j 5.23) as a domain name to resolve via DNS.
53+
Treats `dbms.cluster.endpoints` as a domain name to resolve via DNS.
5454
Expect DNS resolution to provide SRV records with hostnames or IP addresses and ports, of servers to contact for discovery.
5555
`K8S`::
5656
Accesses the Kubernetes list service API to derive addresses of servers to contact for discovery.
5757
Requires `dbms.kubernetes.label_selector` to be a Kubernetes label selector for Kubernetes services running a server each and `dbms.kubernetes.service_port_name` to be a service port name identifying the discovery port of cluster servers services.
58-
The value of `dbms.cluster.discovery.endpoints` (or `dbms.cluster.discovery.v2.endpoints`, if you use discovery service v2 available as of Neo4j 5.23) is ignored for this option.
58+
The value of `dbms.cluster.endpoints` is ignored for this option.
5959
For more details, see xref:clustering/setup/discovery.adoc#clustering-discovery-k8s[Discovery in Kubernetes].
6060

61-
From Neo4j 5.23, depending on which version of the discovery service you are using, you need to set either `dbms.cluster.discovery.endpoints` or `dbms.cluster.discovery.v2.endpoints` in the _neo4j.conf_ file.
61+
You need to set `dbms.cluster.endpoints` in the _neo4j.conf_ file.
6262
Detailed information about discovery and discovery configuration options is given in xref:clustering/setup/discovery.adoc#clustering-discovery-methods[Methods for server discovery].
6363

64-
| xref:configuration/configuration-settings.adoc#config_dbms.cluster.discovery.endpoints[`dbms.cluster.discovery.endpoints`] label:deprecated[Deprecated in 5.23]
65-
| One or more network addresses used to discover other servers in the cluster.
66-
The exact method by which endpoints are resolved to other cluster members is determined by the value of `dbms.cluster.discovery.resolver_type`.
67-
In the default case, the initial discovery members are given as a comma-separated list of address/port pairs, and the default port for the discovery service is `:5000`.
68-
69-
It is good practice to set this parameter to the same value on all servers in the cluster.
70-
71-
**Example:** `dbms.cluster.discovery.resolver_type=LIST` combined with `server01.example.com:5000,server02.example.com:5000,server03.example.com:5000` attempt to reach Neo4j instances listening on _server01.example.com_, _server02.example.com_ and _server03.example.com_; all on port `5000`.
72-
73-
|xref:configuration/configuration-settings.adoc#config_dbms.cluster.discovery.v2.endpoints[`dbms.cluster.discovery.v2.endpoints`] label:new[Introduced in 5.22]
64+
|xref:configuration/configuration-settings.adoc#config_dbms.cluster.discovery.v2.endpoints[`dbms.cluster.endpoints`]
7465
|A comma-separated list of endpoints that a server should contact in order to discover other cluster members.
7566
Typically, all cluster members, including the current server, must be specified in this list.
76-
The setting configures the endpoints for discovery service v2.
7767

7868
**Example:** `dbms.cluster.discovery.resolver_type=LIST` combined with `server01.example.com:6000,server02.example.com:6000,server03.example.com:6000` attempt to reach Neo4j instances listening on _server01.example.com_, _server02.example.com_ and _server03.example.com_; all on port `6000`.
7969

80-
|xref:configuration/configuration-settings.adoc#config_dbms.cluster.discovery.version[`dbms.cluster.discovery.version`] label:new[Introduced in 5.22]
81-
|This setting allows you to select which discovery service should be started.
82-
Possible values are:
83-
84-
* V1_ONLY -— it runs only discovery service v1.
85-
86-
* V1_OVER_V2 -— it runs both discovery service v1 and discovery service v2, where v1 is the main service and v2 runs in the background.
87-
88-
* V2_OVER_V1 -— it runs both discovery service v1 and discovery service v2, where v2 is the main service and v1 runs in the background.
89-
90-
* V2_ONLY -- it runs only discovery service v2.
91-
92-
The default value is `V1_ONLY`.
93-
94-
Discovery services v1 and v2 are designed to run in parallel.
95-
They are completely independent of each other, thus allowing you to keep the cluster functioning while switching over from v1 to v2.
96-
For details on how to move from discovery service v1 to v2, see xref:clustering/setup/discovery.adoc#clustering-discovery-v1-to-v2[Moving from discovery service v1 to v2].
97-
98-
| xref:configuration/configuration-settings.adoc#config_server.discovery.advertised_address[`server.discovery.advertised_address`] label:deprecated[Deprecated in 5.23]
99-
| The address/port setting that specifies where the instance advertises that it listens for discovery protocol messages from other members of the cluster.
100-
If this server is included in the `discovery.endpoints` of other cluster members, the value there must **exactly** match this advertised address.
101-
102-
**Example:** `server.discovery.advertised_address=192.168.33.21:5001` indicates that other cluster members can communicate with this server using the discovery protocol at host `192.168.33.20` and port `5001`.
103-
10470
| xref:configuration/configuration-settings.adoc#config_server.cluster.raft.advertised_address[`server.cluster.raft.advertised_address`]
10571
| The address/port setting that specifies where the Neo4j server advertises to other members of the cluster that it listens for Raft messages within the cluster.
10672

@@ -111,11 +77,6 @@ If this server is included in the `discovery.endpoints` of other cluster members
11177

11278
**Example:** `causal_clustering.transaction_advertised_address=192.168.33.20:6001` listens for transactions from cluster members on the network interface bound to `192.168.33.20` on port `6001`.
11379

114-
| xref:configuration/configuration-settings.adoc#config_server.discovery.listen_address[`server.discovery.listen_address`] label:deprecated[Deprecated in 5.23]
115-
| The address/port setting that specifies which network interface and port the Neo4j instance binds to for the cluster discovery protocol.
116-
117-
**Example:** `server.discovery.listen_address=0.0.0.0:5001` listens for cluster membership communication on any network interface at port `5001`.
118-
11980
| xref:configuration/configuration-settings.adoc#config_server.cluster.raft.listen_address[`server.cluster.raft.listen_address`]
12081
| The address/port setting that specifies which network interface and port the Neo4j instance binds to for cluster communication.
12182
This setting must be set in coordination with the address this instance advertises it listens at in the setting `server.cluster.raft.advertised_address`.

0 commit comments

Comments
 (0)