diff --git a/modules/ROOT/pages/backup-restore/online-backup.adoc b/modules/ROOT/pages/backup-restore/online-backup.adoc index 995d65cc7..67c6445d8 100644 --- a/modules/ROOT/pages/backup-restore/online-backup.adoc +++ b/modules/ROOT/pages/backup-restore/online-backup.adoc @@ -64,13 +64,11 @@ 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|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-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=[,...]]... [...] ---- === Description @@ -128,11 +126,11 @@ If is "*", `neo4j-admin` will attempt to back up all databases of the |Show this help message and exit. | -|--include-metadata=none\|all\|users\|roles -|Include metadata in the file. This cannot be used for backing up the `system` database. Possible values are: +|--include-metadata=none\|all\|users[=user1,user2]\|roles +|label:new[Changed in 2025.10] Include metadata in the file. This cannot be used for backing up the `system` database. Possible values are: - `roles` - include commands to create the roles and privileges (for both database and graph) that affect the use of the database. -- `users` - include commands to create the users that can use the database and their role assignments. +- `users` - include commands to create the users that can use the database and their role assignments. If a list of users is specified (e.g. `users=alice,bob,charlie`), only those users are included in the backup. - `all` - include both `roles` and `users`. - `none` - does not include any metadata. [NOTE] diff --git a/modules/ROOT/pages/changes-deprecations-removals.adoc b/modules/ROOT/pages/changes-deprecations-removals.adoc index f494a6e0a..d6d4ee7c4 100644 --- a/modules/ROOT/pages/changes-deprecations-removals.adoc +++ b/modules/ROOT/pages/changes-deprecations-removals.adoc @@ -598,9 +598,19 @@ The section covers changes to Neo4j server functionality across different areas. === Neo4j-admin tool +Neo4j 2025.10:: + +* label:enterprise[Enterprise Edition] The `neo4j-admin database backup` command. ++ +The `--include-metadata=none|all|users[=user1,user2]|roles` option is changed. +Now it allows filtering users when performing a database backup. + +Previously, if you specified `users` with `--include-metadata`, the backup file would include commands to create the users that can use the database and their role assignments. +Starting from 2025.10, you can define a list of specific users (e.g., `users=alice,bob,charlie`), which means only those users are included in the backup. +For details, refer to xref:backup-restore/online-backup.adoc[]. + Neo4j 2025.01:: -* The `neo4j-admin database copy` command. +* label:enterprise[Enterprise Edition] The `neo4j-admin database copy` command. + The functionality of the `--from-pagecache=` option is changed. + Instead of specifying how much cache to allocate when reading the source, now you can control the maximum amount of off-heap memory used for the copy operation, both for reading and writing.