Skip to content

Commit 6092876

Browse files
Publish 2025.09 release
2 parents bf61a89 + b4a5f48 commit 6092876

File tree

4 files changed

+37
-10
lines changed

4 files changed

+37
-10
lines changed

antora.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
name: operations-manual
22
title: Operations Manual
3-
version: '2025.08'
3+
version: '2025.09'
44
current: true
55
start_page: ROOT:index.adoc
66
nav:
77
- modules/ROOT/content-nav.adoc
88
asciidoc:
99
attributes:
10-
neo4j-version: '2025.08'
11-
neo4j-version-minor: '2025.08'
12-
neo4j-version-exact: '2025.08.0'
13-
neo4j-buildnumber: '2025.08'
14-
neo4j-debian-package-version: '1:2025.08.0@'
10+
neo4j-version: '2025.09'
11+
neo4j-version-minor: '2025.09'
12+
neo4j-version-exact: '2025.09.0'
13+
neo4j-buildnumber: '2025.09'
14+
neo4j-debian-package-version: '1:2025.09.0@'

modules/ROOT/pages/backup-restore/consistency-checker.adoc

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ Value can be plain numbers, like `10000000` or e.g. `20G` for 20 gigabytes, or e
115115
| xref:configuration/configuration-settings.adoc#config_server.directories.transaction.logs.root[`server.directories.transaction.logs.root`]
116116

117117
|--from-path=<path>
118-
|Path to the directory containing dump/backup artifacts that need to be checked for consistency. If the directory contains multiple backups, it will select the most recent backup chain, based on the transaction IDs found, to perform the consistency check.
118+
|label:changed[Changed in 2025.09] Path to a backup file or a directory containing dump/backup artifacts. If the path is to a single file, that artifact is selected and checked for consistency. If a directory is provided, the tool selects the most recent backup chain (based on transaction IDs) within it and checks that chain for consistency.
119119
|
120120

121121
|--temp-path=<path>
@@ -208,11 +208,14 @@ The backup chain must be aggregated into a full recovered backup artifact before
208208
See xref:backup-restore/aggregate.adoc[] for more details.
209209
====
210210

211-
Run with the `--from-path` option to check the consistency of a backup or a dump:
211+
212+
Run with the `--from-path` option to check the consistency of a backup or a dump. +
213+
Starting with Neo4j 2025.09, the option accepts a path to a specific backup or dump file you want to be checked for consistency.
214+
If only the directory is provided, the most recent backup chain (based on transaction IDs) within that directory will be checked.
212215

213216
[source,shell]
214217
----
215-
bin/neo4j-admin database check --from-path=<directory-with-backup-or-dump> neo4j
218+
bin/neo4j-admin database check --from-path=<path-to-backup-or-dump> neo4j
216219
----
217220

218221
[[check-database-from-cloud-uris]]

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

Lines changed: 22 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,26 @@ 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+
The server selection occurs in the following order:
381+
382+
* The DBMS first selects all servers hosting the database in secondary mode.
383+
* 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.
384+
385+
365386
[[online-backup-example]]
366387
== Examples
367388

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,9 @@ Backing up a database in a clustered environment is not essentially different fr
183183
Use `SHOW DATABASE <database>` to learn which servers are hosting the database you want to back up.
184184
See xref:clustering/monitoring/show-databases-monitoring.adoc#show-databases-monitoring-listing-single[Listing a single database] for more information.
185185

186+
Starting from 2025.09, you can use the `--remote-address-resolution` option to let the DBMS select which servers to use as backup sources.
187+
See xref:backup-restore/online-backup.adoc#_using_remote_address_resolution[Back up an online database -> Cluster configurations] for more details.
188+
186189
Restoring from the command line involves putting a copy of the database on disk on each server that will need it.
187190
That can be awkward to achieve.
188191
The recommended way to restore a database in a cluster is to xref::database-administration/standard-databases/seed-from-uri.adoc[seed from URI].

0 commit comments

Comments
 (0)