11[role=enterprise-edition]
22[[aggregate-backup]]
33= 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 .
55
66[[aggregate-backup-command]]
77== Command
@@ -17,6 +17,8 @@ The benefits of aggregating a backup chain are notably:
1717As part of the aggregation, transactions contained in the differential backups are applied to the store contained in the full backup artifact.
1818This operation is called _recovery_ and can be costly.
1919* 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.
2022
2123
2224[role=label--changed-2025.01]
@@ -205,3 +207,40 @@ bin/neo4j-admin backup aggregate --from-path=azb://myStorageAccount/myContainer/
205207----
206208======
207209=====
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