Improve the page on managing servers in cluster (#2686)

Co-authored-by: Jack Waudby <[email protected]>

Author: NataliaIvakina

modules/ROOT/images/server-lifecycle.svg

@@ -16,7 +16,8 @@ The `system` database contains metadata on the DBMS and security configuration.
 When connected to this database you can only perform a specific set of administrative tasks, such as managing databases, servers, and access control.
 
 In the clustered environment, the `system` database can be in a primary or secondary mode.
-To configure its mode, use the xref:configuration/configuration-settings.adoc#config_server.cluster.system_database_mode[`server.cluster.system_database_mode`] setting.
+To configure its mode, use the xref:configuration/configuration-settings.adoc#config_server.cluster.system_database_mode[`server.cluster.system_database_mode`] setting in the _neo4j.conf_ file.
+This has to be done before starting the Neo4j process.
 
 Deploying a cluster for the first time, consider configuring the xref:configuration/configuration-settings.adoc#config_dbms.cluster.minimum_initial_system_primaries_count[`dbms.cluster.minimum_initial_system_primaries_count`].
 This setting defaults to `3`.

modules/ROOT/images/server-states.png

@@ -17,6 +17,7 @@ This chapter describes the following:
 * xref:clustering/servers.adoc[Managing servers in a cluster] -- How to manage the servers in a cluster.
 * xref:clustering/unbind.adoc[Unbind a server] -- How to remove and archive the cluster state of a cluster server so that it can rebind to a cluster.
 * xref:clustering/databases.adoc[Managing databases in a cluster] -- How to manage the databases in a cluster.
+* xref:clustering/unbind-system-database.adoc[Unbind the `system` database] -- How to remove and archive the cluster state for the `system` database.
 * Monitoring -- Monitoring of a cluster.
 ** xref:clustering/monitoring/show-servers-monitoring.adoc[Monitor servers] -- The tools available for monitoring the servers in a cluster.
 ** xref:clustering/monitoring/show-databases-monitoring.adoc[Monitor databases] -- The tools available for monitoring the databases in a cluster.

modules/ROOT/images/server-states2.png

@@ -1,21 +1,23 @@
 :description: This section provides a summary of server management Cypher syntax.
 [role=enterprise-edition]
 [[server-commands-reference]]
-= Server commands reference
+= Server management command syntax
 
-Servers can be added and managed using a set of Cypher administration commands executed against the `system` database.
+Servers can be added and managed using a set of Cypher administrative commands executed against the `system` database.
 
-When connected to the DBMS over `bolt`, administration commands are automatically routed to the `system` database.
+When connected to the DBMS over `bolt`, administrative commands are automatically routed to the `system` database.
 
 
 [[server-management-syntax]]
 == Server management command syntax
 
 [NOTE]
 ====
-More details about the syntax descriptions can be found xref:database-administration/syntax.adoc[here].
+More details about the syntax descriptions can be found on the page xref:database-administration/syntax.adoc#administration-syntax-reading[Database management command syntax -> Reading the administrative commands syntax].
 ====
 
+=== Enable a server
+
 [cols="<15s,<85"]
 |===
 | Command
@@ -38,73 +40,86 @@ a| `GRANT SERVER MANAGEMENT`
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
 
+
+=== List servers
+
 [cols="<15s,<85"]
 |===
 | Command
-m| ALTER SERVER
+m| SHOW SERVERS
 
 | Syntax
 a|
 [source, syntax, role=noheader]
 ----
-ALTER SERVER 'name' SET OPTIONS "{" option: value[,...] "}"
+SHOW SERVER[S]
+  [YIELD { * \| field[, ...] } [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
+  [WHERE expression]
+  [RETURN field[, ...] [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
 ----
 
 | Description
-a| Changes the constraints for a server.
-For more information see xref:clustering/servers.adoc#alter-server-options[Altering server options].
+a| Lists all servers visible to the cluster.
+For more information see xref:clustering/servers.adoc#_listing_servers[Listing servers].
 
 | Required privilege
-a| `GRANT SERVER MANAGEMENT`
+a| `GRANT SHOW SERVERS`
 
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
 
+
+=== Alter server's options
+
 [cols="<15s,<85"]
 |===
 | Command
-m| RENAME SERVER
+m| ALTER SERVER
 
 | Syntax
 a|
 [source, syntax, role=noheader]
 ----
-RENAME SERVER 'name' TO 'newName'
+ALTER SERVER 'name' SET OPTIONS "{" option: value[,...] "}"
 ----
 
 | Description
-a| Changes the name of a server.
-For more information see xref:clustering/servers.adoc#_renaming_a_server[Renaming a server].
+a| Changes the constraints for a server.
+For more information see xref:clustering/servers.adoc#alter-server-options[Altering server options].
 
 | Required privilege
 a| `GRANT SERVER MANAGEMENT`
 
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
 
+=== Rename a server
 
 [cols="<15s,<85"]
 |===
 | Command
-m| DEALLOCATE DATABASES
+m| RENAME SERVER
 
 | Syntax
 a|
 [source, syntax, role=noheader]
 ----
-[DRYRUN] DEALLOCATE DATABASE[S] FROM SERVER[S] 'name'[, ...]
+RENAME SERVER 'name' TO 'newName'
 ----
 
 | Description
-a| Removes all databases from the given servers.
-For more information see xref:clustering/servers.adoc#_deallocating_databases_from_a_server[Deallocating databases from  server].
+a| Changes the name of a server.
+For more information see xref:clustering/servers.adoc#_renaming_a_server[Renaming a server].
 
 | Required privilege
 a| `GRANT SERVER MANAGEMENT`
 
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
 
+
+=== Remove a server
+
 [cols="<15s,<85"]
 |===
 | Command
@@ -127,51 +142,55 @@ a| `GRANT SERVER MANAGEMENT`
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
 
+
+=== Reallocate databases in a cluster
+
 [cols="<15s,<85"]
 |===
 | Command
-m| SHOW SERVERS
+m| REALLOCATE DATABASES
 
 | Syntax
 a|
 [source, syntax, role=noheader]
 ----
-SHOW SERVER[S]
-  [YIELD { * \| field[, ...] } [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
-  [WHERE expression]
-  [RETURN field[, ...] [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
+[DRYRUN] REALLOCATE DATABASE[S]
 ----
 
 | Description
-a| Lists all servers visible to the cluster.
-For more information see xref:clustering/servers.adoc#_listing_servers[Listing servers].
+a| Re-balances databases among the servers in the cluster.
+For more information see xref:clustering/servers.adoc#_hosting_databases_on_added_servers[Hosting databases on added servers].
+
+Note that is a cluster-level command, not a server-level command.
 
 | Required privilege
-a| `GRANT SHOW SERVERS`
+a| `GRANT SERVER MANAGEMENT`
 
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
 
+
+=== Deallocate databases from a server
+
 [cols="<15s,<85"]
 |===
 | Command
-m| REALLOCATE DATABASES
+m| DEALLOCATE DATABASES
 
 | Syntax
 a|
 [source, syntax, role=noheader]
 ----
-[DRYRUN] REALLOCATE DATABASE[S]
+[DRYRUN] DEALLOCATE DATABASE[S] FROM SERVER[S] 'name'[, ...]
 ----
 
 | Description
-a| Re-balances databases among the servers in the cluster.
-For more information see xref:clustering/servers.adoc#_hosting_databases_on_added_servers[Hosting databases on added servers].
-
-Note that is a cluster-level command, not a server-level command.
+a| Removes all user databases from the given servers.
+For more information see xref:clustering/servers.adoc#_deallocating_databases_from_a_server[Deallocating databases from  server].
 
 | Required privilege
 a| `GRANT SERVER MANAGEMENT`
 
 (see xref:authentication-authorization/dbms-administration.adoc#access-control-dbms-administration-privilege-management[SERVER MANAGEMENT privileges])
 |===
+