diff --git a/modules/ROOT/pages/clustering/databases.adoc b/modules/ROOT/pages/clustering/databases.adoc index f4f9143d3..c2def73b3 100644 --- a/modules/ROOT/pages/clustering/databases.adoc +++ b/modules/ROOT/pages/clustering/databases.adoc @@ -138,7 +138,7 @@ By default, a newly created database has both read and write access. [[deallocate-databases]] == Deallocate databases -To relieve the load of a specific server(s), you can use one of the following procedures to deallocate databases causing the pressure from the server(s): +To relieve the load of a specific server(s), you can use one of the following procedures to deallocate databases, causing the databases to be removed from the server(s) under pressure: * xref:procedures.adoc#procedure_dbms_cluster_deallocateDatabaseFromServer[`dbms.cluster.deallocateDatabaseFromServer("server-name", "database-name")`] * xref:procedures.adoc#procedure_dbms_cluster_deallocateDatabaseFromServers[`dbms.cluster.deallocateDatabaseFromServers(["server-name1", "server-name2"\], "database-name")`] diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index 01ab89863..777b8f99d 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -82,10 +82,16 @@ Once enabled, the server may be allocated databases to host. [[deallocating-state]] === Deallocating state -When a server is no longer needed, it cannot be removed from the cluster while it is still allocated to host any databases. +A server in a deallocating state means that it can no longer host databases. +It may be that the server is no longer needed and you want to remove it from the cluster. The command `DEALLOCATE DATABASE[S] FROM SERVER[S] _server_[,...]` is used to transition servers to the _Deallocating_ state, reallocating all their hosted databases to other servers in the cluster. -Additionally, servers which are deallocating will not have any further databases allocated to them. +[NOTE] +==== +This state is *irreversible*. +Once a server is in a deallocating state, it subsequently cannot have databases allocated to it. +If you want to deallocate databases from a server in a *reversible manner*, see xref:clustering/databases.adoc#deallocate-databases[Deallocate databases] for more information. +==== === Deallocated state