From 00fc473ff3063f5e969dcb3da8f87a4b2bb769a5 Mon Sep 17 00:00:00 2001 From: NataliaIvakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Wed, 18 Dec 2024 11:55:52 +0100 Subject: [PATCH] Update warning on how and when to use the `unbind` command (#2000) --- .../ROOT/pages/tools/neo4j-admin/unbind.adoc | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/modules/ROOT/pages/tools/neo4j-admin/unbind.adoc b/modules/ROOT/pages/tools/neo4j-admin/unbind.adoc index 9fa51860d..f1fe4a0db 100644 --- a/modules/ROOT/pages/tools/neo4j-admin/unbind.adoc +++ b/modules/ROOT/pages/tools/neo4j-admin/unbind.adoc @@ -5,6 +5,18 @@ 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. +[WARNING] +==== +Due to the new clustering architecture in Neo4j 5.x, the behavior of the `unbind` command has changed significantly compared to Neo4j 4.4. + +Running the `unbind` command on any number of servers may result in the loss of cluster quorum, severely affecting clustering functionality. +Therefore, it is strongly recommended to consult with Neo4j Support before using the `unbind` command. + +In Neo4j 5.x, use the `unbind` command only when troubleshooting **a specific server** and remember there is no guarantee that the allocator will reassign the same databases to this server, potentially resulting in orphaned database stores. + +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. +==== + [[unbind-command-syntax]] == Syntax @@ -69,14 +81,6 @@ You can use the `neo4j-admin server unbind` command to remove the cluster state To remove the cluster state of a server, run the `neo4j-admin server unbind` command from the __ folder of that server. When restarted, an unbound server rejoins the cluster as a new server and has to be enabled using the `ENABLE SERVER` command. -[WARNING] -==== -Note that the `unbind` command preserves all database stores on the server. -When the unbound server is restarted and enabled, it is seen as an entirely new server. -Therefore, there is no guarantee that the allocator will pick this server to host the same databases. -This may lead to having orphaned database stores on this server. -==== - === Turn a cluster member into a standalone server 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].