From f54d4afa897a356ed5ce39d3cfb054f751bcada9 Mon Sep 17 00:00:00 2001 From: Jack Waudby Date: Tue, 22 Jul 2025 17:56:04 +0100 Subject: [PATCH 1/8] Fix wording --- modules/ROOT/pages/clustering/databases.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/databases.adoc b/modules/ROOT/pages/clustering/databases.adoc index f4f9143d3..7669275dc 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 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")`] From ff1ead8e43941ca2b2bc0e930944c75c3d52c9a2 Mon Sep 17 00:00:00 2001 From: Jack Waudby Date: Tue, 22 Jul 2025 18:01:40 +0100 Subject: [PATCH 2/8] Deallocating is irreversible --- modules/ROOT/pages/clustering/servers.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index 2ce4ce6ea..18be0afcb 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -84,8 +84,8 @@ Once enabled, the server may be allocated databases to host. When a server is no longer needed, it cannot be removed from the cluster while it is still allocated to host any databases. 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. - +This is an irreversible state and servers which are deallocating will not have any further databases allocated to them. +Note, if you wish to deallocate databases from a server in a reversible manner then see xref:clustering/databases.adoc#deallocate-databases[Deallocate databases] for more information. === Deallocated state From 2e3083076d8b70bcb4caf2f592f034b7b6c6ba6f Mon Sep 17 00:00:00 2001 From: Jack Waudby <33488812+jackwaudby@users.noreply.github.com> Date: Wed, 23 Jul 2025 11:10:22 +0100 Subject: [PATCH 3/8] Update modules/ROOT/pages/clustering/databases.adoc Co-authored-by: Reneta Popova --- modules/ROOT/pages/clustering/databases.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/databases.adoc b/modules/ROOT/pages/clustering/databases.adoc index 7669275dc..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 from the server(s) under pressure: +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")`] From 6f76bd30e897ec179c29f837750f54c916a29df0 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 23 Jul 2025 19:36:28 +0100 Subject: [PATCH 4/8] Update modules/ROOT/pages/clustering/servers.adoc --- modules/ROOT/pages/clustering/servers.adoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index 18be0afcb..36a818782 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -84,7 +84,11 @@ Once enabled, the server may be allocated databases to host. When a server is no longer needed, it cannot be removed from the cluster while it is still allocated to host any databases. 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. -This is an irreversible state and servers which are deallocating will not have any further databases allocated to them. +[WARNING] +==== +This state is *irreversible*. +Once a server is in a deallocating state, it subsequently cannot have databases allocated to it. +==== Note, if you wish to deallocate databases from a server in a reversible manner then see xref:clustering/databases.adoc#deallocate-databases[Deallocate databases] for more information. === Deallocated state From 4858a707156b61a20b8341e6c5387596fdd1f5e3 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Thu, 24 Jul 2025 15:48:57 +0100 Subject: [PATCH 5/8] Update modules/ROOT/pages/clustering/servers.adoc --- modules/ROOT/pages/clustering/servers.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index 36a818782..8900d86d7 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -82,7 +82,8 @@ 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. [WARNING] ==== From aa78a0cd137d9c391f4278e70665798f890d744c Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Thu, 24 Jul 2025 15:59:59 +0100 Subject: [PATCH 6/8] Update modules/ROOT/pages/clustering/servers.adoc --- modules/ROOT/pages/clustering/servers.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index 8900d86d7..8a22030d0 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -85,7 +85,7 @@ Once enabled, the server may be allocated databases to host. 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. -[WARNING] +[NOTE] ==== This state is *irreversible*. Once a server is in a deallocating state, it subsequently cannot have databases allocated to it. From 37766ebb1918688d1d9ae6ed361230eb57a3a3d9 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Thu, 24 Jul 2025 16:00:41 +0100 Subject: [PATCH 7/8] Update modules/ROOT/pages/clustering/servers.adoc --- modules/ROOT/pages/clustering/servers.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index 8a22030d0..a50d7cefe 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -90,7 +90,6 @@ The command `DEALLOCATE DATABASE[S] FROM SERVER[S] _server_[,...]` is used to tr This state is *irreversible*. Once a server is in a deallocating state, it subsequently cannot have databases allocated to it. ==== -Note, if you wish to deallocate databases from a server in a reversible manner then see xref:clustering/databases.adoc#deallocate-databases[Deallocate databases] for more information. === Deallocated state From 9e12affa4f1180a3b8a4c2b87c5e66001d9ee63f Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Thu, 24 Jul 2025 16:00:48 +0100 Subject: [PATCH 8/8] Update modules/ROOT/pages/clustering/servers.adoc --- modules/ROOT/pages/clustering/servers.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/modules/ROOT/pages/clustering/servers.adoc b/modules/ROOT/pages/clustering/servers.adoc index a50d7cefe..8480b58c5 100644 --- a/modules/ROOT/pages/clustering/servers.adoc +++ b/modules/ROOT/pages/clustering/servers.adoc @@ -89,6 +89,8 @@ The command `DEALLOCATE DATABASE[S] FROM SERVER[S] _server_[,...]` is used to tr ==== 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