From 292a844c4d407dce342d2314cc8448aa1000265a Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Fri, 25 Jul 2025 14:21:28 +0100 Subject: [PATCH 1/8] Clarify seed from a URI that dumps can also be used as seeds --- .../standard-databases/seed-from-uri.adoc | 21 +++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index d5e3edd75..033773311 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -54,9 +54,13 @@ Starting from Neo4j 2025.01, seed from URI can also be used in combination with [[neo4j-seed-providers]] == Seed providers in Neo4j -The seed can either be a full backup, a differential backup (see <>), or a dump from an existing database. +The seed can be a full backup, a differential backup (see <>), or a dump from an existing database. +When using `CloudSeedProvider`, the URI can point also to a folder which contains a backup chain. The sources of seeds are called _seed providers_. +Backups have `.backup` extension at the end, while the dumps extension is what the user chooses. +For example, the backup file can be called `myBackup.backup`, while the dump can be called `myDump.dump` or also `myBackup.backup`, or any other name. + The mechanism is pluggable, allowing new sources of seeds to be supported (see link:https://www.neo4j.com/docs/java-reference/current/extending-neo4j/project-setup/#extending-neo4j-plugin-seed-provider[Java Reference -> Implement custom seed providers] for more information). The product has built-in support for seed from a mounted file system (file), FTP server, HTTP/HTTPS server, Amazon S3, Google Cloud Storage, and Azure Cloud Storage. @@ -114,6 +118,7 @@ include::partial$/aws-s3-overrides.adoc[] include::partial$/aws-s3-credentials.adoc[] . Create database from `myBackup.backup`. +This backup can be a full backup or a differential backup, or a dump file. + Using Cypher 5: + @@ -136,6 +141,7 @@ CREATE DATABASE foo OPTIONS { seedURI: 's3://myBucket/myBackup.backup' } include::partial$/gcs-credentials.adoc[] . Create database from `myBackup.backup`. +This backup can be a full backup or a differential backup, or a dump file. + Using Cypher 5: + @@ -158,6 +164,7 @@ CREATE DATABASE foo OPTIONS { seedURI: 'gs://myBucket/myBackup.backup' } include::partial$/azb-credentials.adoc[] . Create database from `myBackup.backup`. +This backup can be a full backup or a differential backup, or a dump file. + Using Cypher 5: + @@ -190,7 +197,7 @@ The `S3SeedProvider` supports: [NOTE] ==== Neo4j comes bundled with necessary libraries for AWS S3 connectivity. -Therefore, if you use `S3SeedProvider`, `aws cli` is not required (as it instead is with `CloudSeedProvider`). +Therefore, if you use `S3SeedProvider`, `aws cli` is not required as it is for `CloudSeedProvider`. ==== The `S3SeedProvider` requires additional configuration. @@ -236,31 +243,41 @@ Where `` and `` are provided by AWS. | `file:` | `FileSeedProvider` | `file:/tmp/backup1.backup` + `file:/tmp/backup1.dump` | `ftp:` | `URLConnectionSeedProvider` | `\ftp://myftp.com/backups/backup1.backup` +`ftp://myftp.com/backups/backup1.dump` | `http:` | `URLConnectionSeedProvider` | `\http://myhttp.com/backups/backup1.backup` +`http://myhttp.com/backups/backup1.dump` | `https:` | `URLConnectionSeedProvider` | `\https://myhttp.com/backups/backup1.backup` +`https://myhttp.com/backups/backup1.dump` | `s3:` | `S3SeedProvider` label:deprecated[Deprecated in 5.26], + `CloudSeedProvider` | `s3://mybucket/backups/backup1.backup` +`s3://mybucket/backups/backup1.dump` +`s3://mybucket/backups/` (folder containing a backup chain, only used by `CloudSeedProvider`) | `gs:` | `CloudSeedProvider` | `gs://mybucket/backups/backup1.backup` +`gs://mybucket/backups/backup1.dump` +`gs://mybucket/backups/` (folder containing a backup chain) | `azb:` | `CloudSeedProvider` | `azb://mystorageaccount.blob/backupscontainer/backup1.backup` +`azb://mystorageaccount.blob/backupscontainer/backup1.dump` +`azb://mystorageaccount.blob/backupscontainer/` (folder containing a backup chain) |=== From d8feab943151ff5d0cfd3e0db19147058217e980 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 11:48:18 +0200 Subject: [PATCH 2/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index 033773311..548d6d4c3 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -58,7 +58,7 @@ The seed can be a full backup, a differential backup (see < Implement custom seed providers] for more information). From cced80028422d1f26a3820dfe69134e325793da9 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 11:54:19 +0200 Subject: [PATCH 3/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index 548d6d4c3..4f8fd45ce 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -248,7 +248,7 @@ Where `` and `` are provided by AWS. | `ftp:` | `URLConnectionSeedProvider` | `\ftp://myftp.com/backups/backup1.backup` -`ftp://myftp.com/backups/backup1.dump` +`\ftp://myftp.com/backups/backup1.dump` | `http:` | `URLConnectionSeedProvider` From 73bb0f213a334d3abdf5e7f638cb8f06f810a254 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 11:54:28 +0200 Subject: [PATCH 4/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index 4f8fd45ce..78bf821bc 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -253,7 +253,7 @@ Where `` and `` are provided by AWS. | `http:` | `URLConnectionSeedProvider` | `\http://myhttp.com/backups/backup1.backup` -`http://myhttp.com/backups/backup1.dump` +`\http://myhttp.com/backups/backup1.dump` | `https:` | `URLConnectionSeedProvider` From 1abb67b03084cd26bbc02b6d871c62c65bcdcc6d Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 11:54:38 +0200 Subject: [PATCH 5/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index 78bf821bc..dbf56f2dd 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -258,7 +258,7 @@ Where `` and `` are provided by AWS. | `https:` | `URLConnectionSeedProvider` | `\https://myhttp.com/backups/backup1.backup` -`https://myhttp.com/backups/backup1.dump` +`\https://myhttp.com/backups/backup1.dump` | `s3:` | `S3SeedProvider` label:deprecated[Deprecated in 5.26], + From 602e83bd3eb287c3afebbb8cdeb1818e83655e57 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 11:59:02 +0200 Subject: [PATCH 6/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index dbf56f2dd..6cfe61e2a 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -141,7 +141,7 @@ CREATE DATABASE foo OPTIONS { seedURI: 's3://myBucket/myBackup.backup' } include::partial$/gcs-credentials.adoc[] . Create database from `myBackup.backup`. -This backup can be a full backup or a differential backup, or a dump file. +This backup can be a full backup, a differential backup, or a dump file. + Using Cypher 5: + From aaa5ec0e7767941ab1a82fc6854c989c5b8a7e63 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 11:59:42 +0200 Subject: [PATCH 7/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index 6cfe61e2a..0eef82234 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -118,7 +118,7 @@ include::partial$/aws-s3-overrides.adoc[] include::partial$/aws-s3-credentials.adoc[] . Create database from `myBackup.backup`. -This backup can be a full backup or a differential backup, or a dump file. +This backup can be a full backup, a differential backup, or a dump file. + Using Cypher 5: + From e4096c522344c77f1608ef0804cd610f25acb2f8 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 4 Aug 2025 12:00:24 +0200 Subject: [PATCH 8/8] Update modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc --- .../standard-databases/seed-from-uri.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc index 0eef82234..570c19d4b 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc @@ -164,7 +164,7 @@ CREATE DATABASE foo OPTIONS { seedURI: 'gs://myBucket/myBackup.backup' } include::partial$/azb-credentials.adoc[] . Create database from `myBackup.backup`. -This backup can be a full backup or a differential backup, or a dump file. +This backup can be a full backup, a differential backup, or a dump file. + Using Cypher 5: +