Skip to content

Rewrite disaster recovery based on recreate and status check #1890

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Dec 20, 2024
Merged

Rewrite disaster recovery based on recreate and status check #1890

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
a727ace
Rewrite disaster recovery to use the new recreate and status check pr…
AnnaSjerling Sep 19, 2024
657b957
Move to new structure.
AnnaSjerling Oct 17, 2024
b88cdad
WIP
AnnaSjerling Oct 21, 2024
29bd007
WIP
AnnaSjerling Oct 21, 2024
526fe08
Making notes about potential problems found during testing.
AnnaSjerling Nov 18, 2024
3140906
Rewrite based on problems found during testing.
AnnaSjerling Nov 28, 2024
43d60b6
Review comments.
AnnaSjerling Dec 9, 2024
dd49ab3
Review comments and make the output examples from e.g. SHOW SERVERS t…
AnnaSjerling Dec 20, 2024
3930931
Update disaster-recovery.adoc
NataliaIvakina Dec 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions modules/ROOT/pages/clustering/databases.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -268,8 +268,8 @@ Neo4j 5.24 introduces the xref:procedures.adoc#procedure_dbms_cluster_recreateDa
* To change the database store to a specified backup, while keeping all the associated privileges for the database.

* To make your database write-available again after it has been lost (for example, due to a disaster).
// See xref:clustering/disaster-recovery.adoc[] for more information.

See xref:clustering/disaster-recovery.adoc[Disaster recovery] for more information.
[CAUTION]
====
The recreate procedure works only for real user databases and not for composite databases, or the `system` database.
Expand Down Expand Up @@ -468,7 +468,7 @@ SHOW DATABASE foo;
=== Seed from URI

This method seeds all servers with an identical seed from an external source, specified by the URI.
The seed can either be a full backup, a differential backup (xref:clustering/databases.adoc#cloud-seed-provider[`CloudSeedProvider`], introduced in Neo4j 5.26), or a dump from an existing database.
The seed can either be a full backup, a differential backup (xref:clustering/databases.adoc#cloud-seed-provider[`CloudSeedProvider`], introduced in Neo4j 5.26), or a dump from an existing database.
The sources of seeds are called _seed providers_.

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).
Expand Down Expand Up @@ -506,7 +506,7 @@ To determine the cause of the problem, it is recommended to look at the `debug.l

label:new[Introduced in 5.26], the `FileSeedProvider` supports:

** `file:`
** `file:`

[[url-connection-seed-provider]]
==== URLConnectionSeedProvider
Expand All @@ -523,8 +523,8 @@ The `URLConnectionSeedProvider` supports the following:

label:new[Introduced in 5.25], the `CloudSeedProvider` supports:

** `s3:`
** `gs:`
** `s3:`
** `gs:`
** `azb:`

Starting from Neo4j 5.26, the `CloudSeedProvider` supports using xref:backup-restore/modes.adoc#differential-backup[differential backup] files as seeds.
Expand All @@ -539,7 +539,7 @@ include::partial$/aws-s3-overrides.adoc[]

include::partial$/aws-s3-credentials.adoc[]

. Create database from `myBackup.backup`.
. Create database from `myBackup.backup`.
+
[source,shell, role="nocopy"]
----
Expand All @@ -552,7 +552,7 @@ CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3:/myBucket/myBack

include::partial$/gcs-credentials.adoc[]

. Create database from `myBackup.backup`.
. Create database from `myBackup.backup`.
+
[source,shell]
----
Expand All @@ -564,7 +564,7 @@ CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 'gs:/myBucket/myBack

include::partial$/azb-credentials.adoc[]

. Create database from `myBackup.backup`.
. Create database from `myBackup.backup`.
+
[source,shell]
----
Expand All @@ -578,7 +578,7 @@ CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 'azb://myStorageAcco

The `S3SeedProvider` supports:

** `s3:` label:deprecated[Deprecated in 5.26]
** `s3:` label:deprecated[Deprecated in 5.26]


[NOTE]
Expand Down Expand Up @@ -621,7 +621,7 @@ Where `accessKey` and `secretKey` are provided by AWS.

| `file:`
| `URLConnectionSeedProvider` label:deprecated[Deprecated in 5.26], +
`FileSeedProvider` label:new[Introduced in 5.26]
`FileSeedProvider` label:new[Introduced in 5.26]
| `file:/tmp/backup1.backup`

| `ftp:`
Expand All @@ -638,15 +638,15 @@ Where `accessKey` and `secretKey` are provided by AWS.

| `s3:`
| `S3SeedProvider` label:deprecated[Deprecated in 5.26], +
`CloudSeedProvider` label:new[Introduced in 5.25]
`CloudSeedProvider` label:new[Introduced in 5.25]
| `s3://mybucket/backups/backup1.backup`

| `gs:`
| `CloudSeedProvider` label:new[Introduced in 5.25]
| `CloudSeedProvider` label:new[Introduced in 5.25]
| `gs://mybucket/backups/backup1.backup`

| `azb:`
| `CloudSeedProvider` label:new[Introduced in 5.25]
| `CloudSeedProvider` label:new[Introduced in 5.25]
| `azb://mystorageaccount.blob/backupscontainer/backup1.backup`
|===

Expand Down
Loading
Loading