Unbind a Neo4j cluster server
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.
Syntax
The neo4j-admin server unbind
command has the following syntax:
neo4j-admin server unbind [-h] [--expand-commands] [--verbose] [--archive-cluster-state[=true|false]] [--additional-config=<file>] [--archive-path=<path>]
Options
The neo4j-admin server unbind
command has the following options:
Option | Description | Default |
---|---|---|
|
Configuration file with additional configuration. |
|
|
Enable or disable the cluster state archiving. |
|
|
Destination (file or folder) of the cluster state archive. |
|
|
Allow command expansion in config value evaluation. |
|
|
Show this help message and exit. |
|
|
Enable verbose output. |
|
1. See Tools → Configuration for details. |
Limitations
The Neo4j server must be shut down before running the neo4j-admin server unbind
command.
Usage
You can use the neo4j-admin server unbind
command to remove the cluster state of a cluster server, turn a cluster server into a standalone server, or remove and archive the cluster state of a cluster server.
Remove the cluster state of a server
To remove the cluster state of a server, run the neo4j-admin server unbind
command from the <NEO4J_HOME> 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.
Note that the |
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 initial.server.mode_constraint
is set to NONE
in The neo4j.conf file.
Archive cluster state
If something goes wrong and debugging is needed, you can archive the cluster state, from the <NEO4J_HOME> folder, run the neo4j-admin server unbind
command with the arguments --archive-cluster-state=true
and --archive-path=<destination-folder>
:
bin/neo4j-admin server unbind --archive-path=/path/to/archive-folder --archive-cluster-state=true
The default resultant file is named:
unbound_cluster_state.<YYYYMMDDHH24MM>.zip