You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- To document a missing step in the guide on how to deploy an analytics
cluster: you have to enable servers that are in the free state.
- To clarify the use and meaning of the initial settings when you deploy
a cluster for the first time.
- To add information about the setting, allowing automatic enabling of
free servers, to the section on the `ENABLED` state of servers.
---------
---------
Co-authored-by: Nick Giles <[email protected]>
Copy file name to clipboardExpand all lines: modules/ROOT/pages/clustering/multi-region-deployment/multi-data-center-routing.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,7 +58,7 @@ Applying the same tag to multiple servers logically groups them together.
58
58
Note that servers can have mulitple tags.
59
59
60
60
Server tags are defined as a key that maps onto a set of servers in a cluster.
61
-
Server tags are defined on each server using the xref:configuration/configuration-settings.adoc#config_server.tags[`initial.server.tags`] parameter in _neo4j.conf_.
61
+
Server tags are defined on each server using the xref:configuration/configuration-settings.adoc#config_initial.server.tags[`initial.server.tags`] parameter in _neo4j.conf_.
62
62
Each server in a cluster can be tagged with to zero or more server tags.
63
63
Server tags can be altered at runtime via the `ALTER SERVER` command,
64
64
see xref:clustering/servers.adoc#alter-server-options[Altering server options] for more details.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/clustering/servers.adoc
+33-3Lines changed: 33 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,8 +35,19 @@ When first discovered, a server's name defaults to the value of its generated se
35
35
[[server-enabled-state]]
36
36
=== Enabled state
37
37
38
-
A server in the free state needs to be explicitly enabled in order to be considered an active member of the cluster.
39
-
The command `ENABLE SERVER server name` is used to transition a server into this _Enabled_ state.
38
+
When you deploy a cluster for the first time, at least the minimum number of servers included in the initial deployment are automatically enabled.
39
+
For details, refer to the example on how to xref:clustering/setup/deploy.adoc#cluster-example-configure-a-three-primary-cluster[Configure a cluster with three servers].
40
+
41
+
If you add a new server after the cluster is already running, the server is added in the `FREE` state.
42
+
A server in the `FREE` state needs to be explicitly enabled in order to be considered an active member of the cluster.
43
+
44
+
To transition a server into the _Enabled_ state, use the command `ENABLE SERVER`:
45
+
46
+
[source, syntax, role=noheader]
47
+
----
48
+
ENABLE SERVER 'serverId' [OPTIONS "{" option: value[,...] "}"]
49
+
----
50
+
40
51
The server's initial name is its ID.
41
52
If the server is already enabled and the command is executed with the same options, nothing is changed.
42
53
@@ -71,11 +82,30 @@ label:new[Introduced in 5.6]
71
82
72
83
[NOTE]
73
84
====
74
-
When a server is enabled, if no `OPTIONS` are not provided, the default server values are taken from the settings `initial.server.mode_constraint`, `initial.server.allowed_databases`, `initial.server.denied_databases`, and/or `initial.server.tags`.
85
+
When a server is enabled, if no `OPTIONS` are provided, the default server's values are taken from the settings:
All these settings are only effective when enabling the relevant server.
75
93
====
76
94
95
+
Another way to enable servers is to configure the DBMS automatically enable free servers.
96
+
You can do this in one of two ways:
97
+
98
+
* By setting xref:configuration/configuration-settings.adoc#config_initial.dbms.automatically_enable_free_servers[`initial.dbms.automatically_enable_free_servers`] to `true` before starting the deployment for the first time.
99
+
* By running the following procedure after deployment:
0 commit comments