|
| 1 | +:description: The page describes the neo4j-admin command `dbms unbind-system-db`. |
| 2 | +[role=enterprise-edition] |
| 3 | + |
| 4 | += Unbind the `system` database |
| 5 | + |
| 6 | +You can use the `neo4j-admin dbms unbind-system-db` command to remove and archive the cluster state for the `system` database, so that the server can rebind to a new `system` database in the cluster. |
| 7 | + |
| 8 | +[[unbind-system-db-syntax]] |
| 9 | +== Syntax |
| 10 | + |
| 11 | +The `neo4j-admin dbms unbind-system-db` command has the following syntax: |
| 12 | + |
| 13 | +---- |
| 14 | +neo4j-admin dbms unbind-system-db [-h] [--expand-commands] [--verbose] [--archive-cluster-state[=true|false]] |
| 15 | + [--additional-config=<file>] [--archive-path=<path>] |
| 16 | +---- |
| 17 | + |
| 18 | + |
| 19 | +[[unbind-system-db-description]] |
| 20 | +== Description |
| 21 | + |
| 22 | +Removes and archives cluster state for `system` database. |
| 23 | + |
| 24 | +[[unbind-system-db-options]] |
| 25 | +== Options |
| 26 | + |
| 27 | + |
| 28 | +The `neo4j-admin dbms unbind-system-db` command has the following options: |
| 29 | + |
| 30 | +.`neo4j-admin dbms unbind-system-db` options |
| 31 | +[options="header", cols="5m,6a,2m"] |
| 32 | +|=== |
| 33 | +| Option |
| 34 | +| Description |
| 35 | +| Default |
| 36 | + |
| 37 | +|--additional-config=<file> |
| 38 | +|Configuration file with additional configuration. |
| 39 | +| |
| 40 | + |
| 41 | +|--archive-cluster-state[=true\|false] |
| 42 | +|Enable or disable the cluster state archiving. |
| 43 | +|false |
| 44 | + |
| 45 | +|--archive-path=<path> |
| 46 | +|Destination (file or folder) of the cluster state archive. |
| 47 | +| |
| 48 | + |
| 49 | +|--expand-commands |
| 50 | +|Allow command expansion in config value evaluation. |
| 51 | +| |
| 52 | + |
| 53 | +|-h, --help |
| 54 | +|Show this help message and exit. |
| 55 | +| |
| 56 | + |
| 57 | +|--verbose |
| 58 | +|Enable verbose output. |
| 59 | +| |
| 60 | +|=== |
| 61 | + |
| 62 | +[[unbind-system-db-limitations]] |
| 63 | +== Limitations |
| 64 | + |
| 65 | +The Neo4j process must be shut down on all servers before running the `neo4j-admin dbms unbind-system-db` command. |
| 66 | + |
| 67 | +[[unbind-system-db-usage]] |
| 68 | +== Usage |
| 69 | + |
| 70 | +The `neo4j-admin dbms unbind-system-db` command removes and archives cluster state for the `system` database, so that the server can rebind to a new `system` database in a cluster. |
| 71 | + |
| 72 | +This command should be run on all remaining members on a cluster to work as expected. Furthermore, the Neo4j process must be shut down before the command is issued. |
| 73 | +For details, see xref:clustering/multi-region-deployment/disaster-recovery.adoc#make-the-system-database-write-available[Disaster recovery guide -> Make the `system` database write-available]. |
| 74 | + |
| 75 | +This does not affect the other databases cluster state. |
| 76 | +However, since all servers in the DBMS need to be shut down when the command is issued, downtime is expected for all databases inside of the DBMS. |
| 77 | + |
0 commit comments