Skip to content

Commit e48f8fe

Browse files
Update warning on how and when to use the unbind command
1 parent 6a68669 commit e48f8fe

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

modules/ROOT/pages/tools/neo4j-admin/unbind.adoc

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,16 @@
55

66
You can use the `neo4j-admin server unbind` command to remove and archive the cluster state of a cluster server so that it can rebind to a cluster.
77

8+
[WARNING]
9+
====
10+
Avoid running the `unbind` command on all servers, as this results in the loss of cluster quorum.
11+
12+
In Neo4j 5.x, use the `unbind` command only when troubleshooting a specific server and you need to convert it into a standalone instance.
13+
14+
Keep in mind there is no guarantee that the allocator will reassign the same databases to this server, potentially resulting in orphaned database stores.
15+
The `unbind` command preserves all database stores on the server; and when the unbound server is restarted and enabled, it is seen as an entirely new server.
16+
====
17+
818
[[unbind-command-syntax]]
919
== Syntax
1020

@@ -69,14 +79,6 @@ You can use the `neo4j-admin server unbind` command to remove the cluster state
6979
To remove the cluster state of a server, run the `neo4j-admin server unbind` command from the _<NEO4J_HOME>_ folder of that server.
7080
When restarted, an unbound server rejoins the cluster as a new server and has to be enabled using the `ENABLE SERVER` command.
7181

72-
[WARNING]
73-
====
74-
Note that the `unbind` command preserves all database stores on the server.
75-
When the unbound server is restarted and enabled, it is seen as an entirely new server.
76-
Therefore, there is no guarantee that the allocator will pick this server to host the same databases.
77-
This may lead to having orphaned database stores on this server.
78-
====
79-
8082
=== Turn a cluster member into a standalone server
8183

8284
To start the Neo4j server in single (standalone) mode after unbinding it from the cluster, verify that xref:configuration/configuration-settings.adoc#config_initial.server.mode_constraint[`initial.server.mode_constraint`] is set to `NONE` in xref:configuration/neo4j-conf.adoc[The neo4j.conf file].

0 commit comments

Comments
 (0)