Skip to content

Commit 5333a3f

Browse files
authored
Update neo4j-admin database backup syntax and options to reflect the code (#697)
Cherry-picked from #694
1 parent 895c410 commit 5333a3f

File tree

1 file changed

+72
-83
lines changed

1 file changed

+72
-83
lines changed

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

Lines changed: 72 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,8 @@ image::backup-chain.png[title="Backup chain",role="middle"]
4141
[[backup-command-usage]]
4242
=== Usage
4343

44-
The `neo4j-admin database backup` command can be used for performing both full and differential backups of an **online** database.
44+
The `neo4j-admin database backup` command can be used for performing an online full or differential backup from a running Neo4j Enterprise server.
45+
Neo4j's backup service must have been configured on the server beforehand.
4546
The command can be run both locally and remotely.
4647
However, it uses a significant amount of resources, such as memory and CPU.
4748
Therefore, it is recommended to perform the backup on a separate dedicated machine.
@@ -58,115 +59,103 @@ For more information, see xref:backup-restore/online-backup.adoc#online-backup-c
5859

5960
[source,role=noheader]
6061
----
61-
neo4j-admin database backup --to-path=<path>
62-
[--from=<host:port>[,<host:port>]...]
63-
[--type=<type>]
64-
[--compress=<true/false>]
65-
[--keep-failed=<true/false>]
66-
[--pagecache=<size>]
67-
[--include-metadata=<all/users/roles>]
68-
[--parallel-recovery=<true/false>]
69-
[--inspect-path=<path>]
70-
[--verbose]
71-
[--expand-commands]
72-
[--additional-config=<path>]
73-
<database>
62+
neo4j-admin database backup [-h] [--expand-commands] [--verbose]
63+
[--compress[=true|false]] [--keep-failed[=true|false]]
64+
[--parallel-recovery[=true|false]]
65+
[--additional-config=<file>]
66+
[--include-metadata=none|all|users|roles]
67+
[--inspect-path=<path>] [--pagecache=<size>]
68+
[--to-path=<path>] [--type=<type>]
69+
[--from=<host:port>[,<host:port>...]]...
70+
[<database>]
7471
----
7572

73+
[[backup-backup-command-parameters]]
74+
=== Parameters
7675

77-
[[backup-command-options]]
78-
=== Options
79-
80-
[options="header",cols="m,m,a"]
76+
.`neo4j-admin database backup` parameters
77+
[options="header", cols="1m,3a,1m"]
8178
|===
82-
| Option
79+
| Parameter
8380
| Default
8481
| Description
8582

86-
| --to-path
87-
|
88-
| Directory to place backup in.
89-
90-
| --from
91-
| localhost:6362
92-
| Comma-separated list of host and port of Neo4j instances, each of which are tried in order.
93-
94-
| --type
95-
| AUTO
96-
| Type of backup to perform. Possible values are: `FULL`, `DIFF`, `AUTO`.
83+
|<database>
84+
|Name of the remote database to backup. Can contain `*` and `?` for globbing (required unless `--inspect-path` is used).
85+
|neo4j
86+
|===
9787

98-
| --compress
99-
| true
100-
| Request backup artifact to be compressed.
101-
If disabled, backup artifact creation is faster but the size of the produced artifact is approximately equal to the size of backed-up database.
88+
[TIP]
89+
====
90+
With a single `*` as a value, you can back up all the databases of the DBMS.
91+
====
10292

103-
| --keep-failed
104-
| false
105-
| Request failed backup to be preserved for further post-failure analysis.
106-
If enabled, a directory with the failed backup database is preserved.
93+
[[backup-command-options]]
94+
=== Options
10795

108-
| --pagecache
109-
| 8m
110-
| The size of the page cache to use for the backup process.
96+
.`neo4j-admin database backup` options
97+
[options="header", cols="5m,6a,4m"]
98+
|===
99+
| Option
100+
| Description
101+
| Default
111102

112-
| --include-metadata
103+
|--additional-config=<file>
104+
|Configuration file with additional configuration or override the existing configuration settings in the _neo4j.conf_ file.
113105
|
114-
| Include metadata in the backup.
115-
Metadata contains security settings related to the database.
116-
Cannot be used for backing up the `system` database.
117-
118-
- `roles` - commands to create the roles and privileges (for both database and graph) that affect the use of the database.
119-
- `users` - commands to create the users that can use the database and their role assignments.
120-
- `all` - include roles and users.
121106

122-
| --parallel-recovery
123-
| false
124-
| Allow multiple threads to apply transactions to a backup in parallel.
125-
For some databases and workloads, this may reduce execution times significantly.
107+
|--compress[=true\|false]
108+
|Request backup artifact to be compressed. If disabled, backup artifact creation is faster but the size of the produced artifact will be approximately equal to the size of backed-up database.
109+
|true
126110

127-
[NOTE]
128-
====
129-
`parallel-recovery` is an experimental option.
130-
Consult Neo4j support before use.
131-
====
132-
133-
| --inspect-path
111+
| --expand-commands
112+
|Allow command expansion in config value evaluation.
134113
|
135-
| List and show the metadata of the backup artifact(s).
136-
Accepts a folder or a file.
137114

138-
| --verbose
115+
|--from=<host:port>[,<host:port>...]
116+
|Comma-separated list of host and port of Neo4j instances, each of which are tried in order.
139117
|
140-
| Enable verbose output.
141118

142-
| --expand-commands
119+
|-h, --help
120+
|Show this help message and exit.
143121
|
144-
| Allow command expansion in config value evaluation.
145122

146-
| --additional-config
123+
|--include-metadata=none\|all\|users\|roles
124+
|Include metadata in file. Can't be used for backing system database.
125+
- roles - commands to create the roles and privileges (for both database and graph) that affect the use of the database
126+
- users - commands to create the users that can use the database and their role assignments
127+
- all - include roles and users
128+
- none - don't include any metadata
129+
|all
130+
131+
|--inspect-path=<path>
132+
|List and show the metadata of the backup artifact(s). Accepts a folder or a file.
147133
|
148-
| Configuration file to provide additional or override the existing configuration settings in the _neo4j.conf_ file.
149-
|===
150134

151-
[[backup-backup-command-parameters]]
152-
=== Parameters
135+
|--keep-failed[=true\|false]
136+
|Request failed backup to be preserved for further post-failure analysis. If enabled, a directory with the failed backup database is preserved.
137+
|false
153138

154-
[options="header",cols="m,m,a"]
155-
|===
156-
| Parameter
157-
| Default
158-
| Description
139+
|--pagecache=<size>
140+
|The size of the page cache to use for the backup process.
141+
|
142+
143+
|--parallel-recovery[=true\|false]
144+
| Allow multiple threads to apply pulled transactions to a backup in parallel. For some databases and workloads, this may reduce backup times significantly.
145+
Note: this is an EXPERIMENTAL option. Consult Neo4j support before use.
146+
|false
159147

160-
| <database>
148+
|--to-path=<path>
149+
|Directory to place backup in (required unless `--inspect-path` is used).
161150
|
162-
| Name of the remote database to back up.
163151

164-
The value can contain `*` and `?` for globbing, in which cases all matching databases are backed up.
152+
|--type=<type>
153+
|Type of backup to perform. Possible values are: `FULL`, `DIFF`, `AUTO`.
154+
|AUTO
165155

166-
[TIP]
167-
====
168-
With a single `*` as a value, you can back up all the databases of the DBMS.
169-
====
156+
|--verbose
157+
|Enable verbose output.
158+
|
170159
|===
171160

172161
[[backup-command-exit-codes]]

0 commit comments

Comments
 (0)