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, you have to aggregate it first.
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