From 8dea20527e4883a61b5f3d107517d8beedfa2fc9 Mon Sep 17 00:00:00 2001 From: sumyiren Date: Tue, 28 Oct 2025 14:50:25 +0000 Subject: [PATCH 1/5] Backup - release --recover and --parallel-download --- .../pages/backup-restore/online-backup.adoc | 32 ++++++++++++++++--- 1 file changed, 27 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/backup-restore/online-backup.adoc b/modules/ROOT/pages/backup-restore/online-backup.adoc index 67c6445d8..9a1792b21 100644 --- a/modules/ROOT/pages/backup-restore/online-backup.adoc +++ b/modules/ROOT/pages/backup-restore/online-backup.adoc @@ -64,11 +64,15 @@ For more information, see xref:backup-restore/online-backup.adoc#online-backup-c [source,role=noheader] ---- -neo4j-admin database backup [-h] [--expand-commands] [--prefer-diff-as-parent] [--verbose] [--compress[=true|false]] - [--keep-failed[=true|false]] [--parallel-recovery[=true|false]] [--remote-address-resolution - [=true|false]] [--additional-config=] [--include-metadata=none|all|users[=user1,user2] - |roles] [--inspect-path=] [--pagecache=] [--temp-path=] - [--to-path=] [--type=] [--from=[,...]]... [...] +neo4j-admin database backup [-h] [--expand-commands] [--prefer-diff-as-parent] [--verbose] + [--compress[=true|false]] [--keep-failed[=true|false]] + [--parallel-download[=true|false]] [--parallel-recovery[=true|false]] + [--remote-address-resolution[=true|false]] [--skip-recovery + [=true|false]] [--additional-config=] + [--include-metadata=none|all|users[=user1,user2]|roles] + [--inspect-path=] [--pagecache=] [--temp-path=] + [--to-path=] [--type=] [--from=[,...]]... [...] ---- === Description @@ -154,6 +158,10 @@ It is recommended to use `SHOW USERS`, `SHOW ROLES`, and `SHOW ROLE $role PRIVIL |The size of the page cache to use for the backup process. | +|--parallel-download[=true\|false] +|label:new[Introduced in 2025.11] Download backup data from multiple Neo4j instances in parallel. +|false + |--parallel-recovery[=true\|false] | Allow multiple threads to apply pulled transactions to a backup in parallel. For some databases and workloads, this may reduce backup times significantly. Note: this is an EXPERIMENTAL option. Consult Neo4j support before use. @@ -167,6 +175,11 @@ Note: this is an EXPERIMENTAL option. Consult Neo4j support before use. |label:new[Introduced in 2025.09] Allow the DBMS to automatically determine which servers are eligible to serve as backup sources, instead of requiring manual selection. |false +|--skip-recovery[=true\|false] +|label:new[Introduced in 2025.11] Skip recovery as part of the full backup. Skipping recovery might result in faster backups, +but recovery will have to be done during restore time. +|true + |--temp-path= |Provide a path to a temporary empty directory for storing backup files until the command is completed. The files will be deleted once the command is finished. | @@ -380,6 +393,15 @@ The server selection occurs in the following order: * The DBMS first selects all servers hosting the database in secondary mode. * If it is not possible to back up from one of the secondaries, the DBMS attempts to take a backup from the primary followers before finally trying the database primary writer. +[role=label--new-2025.11] +==== Using `--parallel-download` + +Starting from 2025.11, the `--parallel-download` option is available. +When enabled, the backup process will pull data from multiple instances which have been either defined in the +--from or determined from --remote-address-resolution. + +Note that this will speed up the backup process if there are enough throughput provisioned in both the +backup process and the instances from which data is being pulled from. [[online-backup-example]] == Examples From 5a08e321ff86ede2357e83e65bce5317aac97258 Mon Sep 17 00:00:00 2001 From: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Thu, 6 Nov 2025 09:26:24 +0100 Subject: [PATCH 2/5] Try to fix the test --- modules/ROOT/pages/backup-restore/online-backup.adoc | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/modules/ROOT/pages/backup-restore/online-backup.adoc b/modules/ROOT/pages/backup-restore/online-backup.adoc index 9a1792b21..12a53949f 100644 --- a/modules/ROOT/pages/backup-restore/online-backup.adoc +++ b/modules/ROOT/pages/backup-restore/online-backup.adoc @@ -71,8 +71,7 @@ neo4j-admin database backup [-h] [--expand-commands] [--prefer-diff-as-parent] [ [=true|false]] [--additional-config=] [--include-metadata=none|all|users[=user1,user2]|roles] [--inspect-path=] [--pagecache=] [--temp-path=] - [--to-path=] [--type=] [--from=[,...]]... [...] + [--to-path=] [--type=] [--from=[,...]]... [...] ---- === Description From 489f44fcbee96820fdda19136e3437f337ddfd11 Mon Sep 17 00:00:00 2001 From: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Thu, 6 Nov 2025 09:52:44 +0100 Subject: [PATCH 3/5] Update modules/ROOT/pages/backup-restore/online-backup.adoc --- modules/ROOT/pages/backup-restore/online-backup.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/backup-restore/online-backup.adoc b/modules/ROOT/pages/backup-restore/online-backup.adoc index 12a53949f..c4dc16f3b 100644 --- a/modules/ROOT/pages/backup-restore/online-backup.adoc +++ b/modules/ROOT/pages/backup-restore/online-backup.adoc @@ -177,7 +177,7 @@ Note: this is an EXPERIMENTAL option. Consult Neo4j support before use. |--skip-recovery[=true\|false] |label:new[Introduced in 2025.11] Skip recovery as part of the full backup. Skipping recovery might result in faster backups, but recovery will have to be done during restore time. -|true +|false |--temp-path= |Provide a path to a temporary empty directory for storing backup files until the command is completed. The files will be deleted once the command is finished. From 4e1f07d712f86431fe2f076a0dc58b1fae49bab7 Mon Sep 17 00:00:00 2001 From: Sum <89913753+yirensum@users.noreply.github.com> Date: Thu, 6 Nov 2025 10:12:29 +0000 Subject: [PATCH 4/5] Apply suggestions from code review Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- modules/ROOT/pages/backup-restore/online-backup.adoc | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/backup-restore/online-backup.adoc b/modules/ROOT/pages/backup-restore/online-backup.adoc index c4dc16f3b..20638b7e6 100644 --- a/modules/ROOT/pages/backup-restore/online-backup.adoc +++ b/modules/ROOT/pages/backup-restore/online-backup.adoc @@ -396,11 +396,9 @@ The server selection occurs in the following order: ==== Using `--parallel-download` Starting from 2025.11, the `--parallel-download` option is available. -When enabled, the backup process will pull data from multiple instances which have been either defined in the ---from or determined from --remote-address-resolution. +When enabled, the backup process pulls data from multiple servers which have been either defined in the `--from` option or determined from `--remote-address-resolution`. -Note that this will speed up the backup process if there are enough throughput provisioned in both the -backup process and the instances from which data is being pulled from. +Note that this will speed up the backup process if sufficient throughput is provisioned for both the backup process and the source servers from which data is being pulled. [[online-backup-example]] == Examples From c38c61db782fd24ed4c0f0cd5ad9b58fd182b35a Mon Sep 17 00:00:00 2001 From: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Thu, 6 Nov 2025 12:37:00 +0100 Subject: [PATCH 5/5] Update online-backup.adoc --- modules/ROOT/pages/backup-restore/online-backup.adoc | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/modules/ROOT/pages/backup-restore/online-backup.adoc b/modules/ROOT/pages/backup-restore/online-backup.adoc index 20638b7e6..ba69b18ee 100644 --- a/modules/ROOT/pages/backup-restore/online-backup.adoc +++ b/modules/ROOT/pages/backup-restore/online-backup.adoc @@ -175,8 +175,7 @@ Note: this is an EXPERIMENTAL option. Consult Neo4j support before use. |false |--skip-recovery[=true\|false] -|label:new[Introduced in 2025.11] Skip recovery as part of the full backup. Skipping recovery might result in faster backups, -but recovery will have to be done during restore time. +|label:new[Introduced in 2025.11] Skip recovery as part of the full backup. Skipping recovery might result in faster backups, but recovery will have to be done during restore time. |false |--temp-path=