Unbind a serverEnterprise Edition
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.
Running the Use the The In 2025.x, the |
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 Neo4j Admin and Neo4j CLI → 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.
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