You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/ROOT/pages/backup-restore/planning.adoc
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -177,7 +177,7 @@ They must be run directly on the databases that are associated with that Composi
177
177
====
178
178
179
179
180
-
=== Considerations for backing up and restoring databases in a cluster
180
+
== Considerations for backing up and restoring databases in a cluster
181
181
182
182
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.
183
183
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
187
187
This method relies on the seed already existing on one of the servers.
188
188
The recommended way to restore a database in a cluster is to xref::database-administration/standard-databases/seed-from-uri.adoc[seed from URI].
189
189
190
-
[NOTE]
190
+
[IMPORTANT]
191
191
====
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.
0 commit comments