1
1
[role=enterprise-edition]
2
2
[[aggregate-backup]]
3
3
= Aggregate a database backup chain
4
- :description: This section describes how to aggregate a backup chain into a single backup.
4
+ :description: This section describes how to aggregate a backup chain into a single backup and recover a full backup .
5
5
6
6
[[aggregate-backup-command]]
7
7
== Command
@@ -17,6 +17,8 @@ The benefits of aggregating a backup chain are notably:
17
17
As part of the aggregation, transactions contained in the differential backups are applied to the store contained in the full backup artifact.
18
18
This operation is called _recovery_ and can be costly.
19
19
* Reduces the risk of losing chain’s links.
20
+ * Some commands, like consistency check, cannot run against a backup chain or a full backup that is not recovered.
21
+ Aggregating produces an artifact they can work against.
20
22
21
23
22
24
[role=label--changed-2025.01]
@@ -205,3 +207,40 @@ bin/neo4j-admin backup aggregate --from-path=azb://myStorageAccount/myContainer/
205
207
----
206
208
======
207
209
=====
210
+
211
+
212
+ [[aggregate-unrecovered-full-backup]]
213
+ === Aggregating an unrecovered full backup
214
+
215
+ To check if a full backup is in a recovered state, run the `neo4j-admin backup inspect` command:
216
+
217
+ [source,shell]
218
+ ----
219
+ bin/neo4j-admin backup inspect /mnt/backups/neo4j-2025-09-10T08-14-56.backup
220
+ ----
221
+
222
+ The output will include the `RECOVERED` column.
223
+ If it shows `false`, the backup is not yet recovered:
224
+
225
+ [output]
226
+ ----
227
+ | FILE | DATABASE | DATABASE ID | TIME (UTC) | FULL | COMPRESSED | LOWEST TX | HIGHEST TX | STORE ID HASH | RECOVERED |
228
+ | file:///mnt/backups/neo4j-2025-09-10T08-14-56.backup | neo4j | 4e98fab8-6ae6-46cc-84c0-61ee8a8db60a | 2025-09-10T08:14:56 | true | true | 1 | 3 | -116350002 | false |
229
+ ----
230
+
231
+ If your full backup is not recovered, aggregating it will perform recovery.
232
+ Run the following command:
233
+
234
+ [source,shell]
235
+ ----
236
+ bin/neo4j-admin backup aggregate --from-path=/mnt/backups/neo4j-2025-09-10T08-14-56.backup --keep-old-backup=true
237
+ ----
238
+
239
+ This command will:
240
+
241
+ * Generate a new, recovered backup alongside the existing one.
242
+ * Preserve the original backup file (due to `--keep-old-backup=true`).
243
+
244
+ After aggregation, you can run consistency checker against the recovered backup and/or restore it.
245
+
246
+
0 commit comments