Skip to content

DEALLOCATING is an irreversible server state #2500

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jul 25, 2025
Merged

DEALLOCATING is an irreversible server state #2500

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
f54d4af
Fix wording
jackwaudby Jul 22, 2025
ff1ead8
Deallocating is irreversible
jackwaudby Jul 22, 2025
2e30830
Update modules/ROOT/pages/clustering/databases.adoc
jackwaudby Jul 23, 2025
6f76bd3
Update modules/ROOT/pages/clustering/servers.adoc
renetapopova Jul 23, 2025
4858a70
Update modules/ROOT/pages/clustering/servers.adoc
renetapopova Jul 24, 2025
aa78a0c
Update modules/ROOT/pages/clustering/servers.adoc
renetapopova Jul 24, 2025
37766eb
Update modules/ROOT/pages/clustering/servers.adoc
renetapopova Jul 24, 2025
9e12aff
Update modules/ROOT/pages/clustering/servers.adoc
renetapopova Jul 24, 2025
3b656e9
Merge branch 'dev' into 25-07-deallocate-db-irrversible
renetapopova Jul 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion modules/ROOT/pages/clustering/databases.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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")`]
Expand Down
11 changes: 8 additions & 3 deletions modules/ROOT/pages/clustering/servers.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,10 +82,15 @@ 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.

[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

Expand Down