Skip to content

Commit a8d7711

Browse files
Change the note
1 parent c670af6 commit a8d7711

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

modules/ROOT/pages/backup-restore/planning.adoc

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ They must be run directly on the databases that are associated with that Composi
177177
====
178178

179179

180-
=== Considerations for backing up and restoring databases in a cluster
180+
== Considerations for backing up and restoring databases in a cluster
181181

182182
Backing up a database in a clustered environment is not essentially different from a standalone backup, apart from the fact that you must know which server in a cluster to connect to.
183183
Use `SHOW DATABASE <database>` to learn which servers are hosting the database you want to back up.
@@ -187,11 +187,12 @@ However, _restoring_ a database in a cluster is different since it is not known
187187
This method relies on the seed already existing on one of the servers.
188188
The recommended way to restore a database in a cluster is to xref::database-administration/standard-databases/seed-from-uri.adoc[seed from URI].
189189

190-
[NOTE]
190+
[IMPORTANT]
191191
====
192-
When backing up a clustered database, use the `--include-metadata=all` option.
193-
This option ensures that the backup includes not only `users` and `roles`, but also the cluster topology.
194-
Cluster topology metadata, stored in the `system` database, defines the servers in the cluster and their operational modes.
192+
When backing up a clustered database, be aware that the xref:clustering/introduction.adoc#clustering-introduction-operational[cluster topology] metadata is not included in the backup.
193+
The cluster topology is stored in the `system` database and describes how the copies of a database should be spread across the servers in a cluster.
194+
195+
Because this metadata is excluded from backups, restoring to a new cluster environment requires manual reconfiguration of servers modes and database allocations.
195196
====
196197

197198
[[backup-planning-databases]]

0 commit comments

Comments
 (0)