Skip to content

Commit 6d7bc16

Browse files
Document --remote-address-resolution
1 parent 0f0ce11 commit 6d7bc16

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

modules/ROOT/pages/backup-restore/online-backup.adoc

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,8 @@ For more information, see xref:backup-restore/online-backup.adoc#online-backup-c
6666
----
6767
neo4j-admin database backup [-h] [--expand-commands] [--prefer-diff-as-parent] [--verbose]
6868
[--compress[=true|false]] [--keep-failed[=true|false]]
69-
[--parallel-recovery[=true|false]] [--additional-config=<file>]
69+
[--parallel-recovery[=true|false]] [--remote-address-resolution
70+
[=true|false]] [--additional-config=<file>]
7071
[--include-metadata=none|all|users|roles] [--inspect-path=<path>]
7172
[--pagecache=<size>] [--temp-path=<path>] [--to-path=<path>]
7273
[--type=<type>] [--from=<host:port>[,<host:port>...]]... [<database>...]
@@ -164,6 +165,10 @@ Note: this is an EXPERIMENTAL option. Consult Neo4j support before use.
164165
|label:new[Introduced in 2025.04] When performing a differential backup, prefer the latest non-empty differential backup as the parent instead of the latest backup.
165166
|false
166167

168+
|--remote-address-resolution[=true|false]
169+
|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.
170+
|false
171+
167172
|--temp-path=<path>
168173
|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.
169174
|
@@ -358,10 +363,21 @@ To view the latest processed transaction IDs (and other metrics) in Neo4j Browse
358363
====
359364

360365
==== Targeting multiple servers
366+
361367
It is recommended to provide a list of multiple target servers when taking a backup from a cluster, since that may allow a backup to succeed even if some server is down, or not all databases are hosted on the same servers.
362368
If the command finds one or more servers that do not respond, it continues trying to backup from other servers and continues backing up other requested databases, but the exit code of the command is non-zero, to alert the user to the fact there is a problem.
363369
If a name pattern is used for the database together with multiple target servers, all servers contribute to the list of matching databases.
364370

371+
[role=label--new-2025.09]
372+
==== Using `--remote-address-resolution`
373+
374+
Starting from 2025.09, the `--remote-address-resolution` option is available.
375+
When enabled, the DBMS automatically selects the most appropriate servers to act as backup sources for a given database.
376+
377+
By default, the online backup command requires the user to determine which servers host the target database and direct the command to one of them.
378+
With remote address resolution enabled, the DBMS performs this mapping automatically, removing the need for manual server selection.
379+
380+
365381
[[online-backup-example]]
366382
== Examples
367383

0 commit comments

Comments
 (0)