Skip to content
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.

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

Rewrite disaster recovery based on recreate and status check (#1890) #2027

Merged
merged 1 commit into from
Dec 20, 2024

Conversation

NataliaIvakina
Copy link
Contributor

This PR rewrites the disaster recovery docs based on the new recreate and status check procedures.

With regards to the functional changes there are three major things to note.

  1. The recovery of the system database is the same as before, even though the way we check if the system db is write available or not has changed.
  2. The step which removes lost servers now also includes recreating some databases. It was decided this mixing of recovering servers and databases is necessary to get recreate into the guide in the best way we could see.
  3. Previously it was not clear how to handle quarantined databases, even though the guide mentioned them in the intro. Now, it is more explicitly discussed how they are supposed to be handles during disaster recovery.

In the past, we have also gotten feedback that the disaster recovery docs are hard to follow. Therefore, this PR also includes refactoring which introduces a new guide structure. This new structure provides more explanations of why we are asking the user to do a certain thing.


)

This PR rewrites the disaster recovery docs based on the new recreate
and status check procedures.

With regards to the functional changes there are three major things to
note.
1. The recovery of the system database is the same as before, even
though the way we check if the system db is write available or not has
changed.
2. The step which removes lost servers now also includes recreating some
databases. It was decided this mixing of recovering servers and
databases is necessary to get recreate into the guide in the best way we
could see.
3. Previously it was not clear how to handle quarantined databases, even
though the guide mentioned them in the intro. Now, it is more explicitly
discussed how they are supposed to be handles during disaster recovery.


In the past, we have also gotten feedback that the disaster recovery
docs are hard to follow. Therefore, this PR also includes refactoring
which introduces a new guide structure. This new structure provides more
explanations of why we are asking the user to do a certain thing.

---------

Co-authored-by: NataliaIvakina <[email protected]>
@neo-technology-commit-status-publisher
Copy link
Collaborator

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.

@NataliaIvakina NataliaIvakina merged commit 1e0f118 into neo4j:5.x Dec 20, 2024
4 checks passed
@NataliaIvakina NataliaIvakina deleted the 5.x-disaster-cherry-pick branch December 20, 2024 13:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants