elasticsearch icon indicating copy to clipboard operation
elasticsearch copied to clipboard

[DOCS] uni-directional CCR disaster recovery

Open Leaf-Lin opened this issue 3 years ago • 3 comments

Detailed step-by-step tutorial for uni-directional CCR disaster recovery

closes: https://github.com/elastic/elasticsearch/issues/84854

Leaf-Lin avatar May 25 '22 06:05 Leaf-Lin

Pinging @elastic/es-docs (Team:Docs)

elasticmachine avatar May 25 '22 06:05 elasticmachine

Pinging @elastic/es-distributed (Team:Distributed)

elasticmachine avatar May 25 '22 06:05 elasticmachine

@elasticmachine run elasticsearch-ci/docs @elasticmachine run elasticsearch-ci/docs-check

henningandersen avatar Sep 19 '22 11:09 henningandersen

@elasticmachine run elasticsearch-ci/docs @elasticmachine run elasticsearch-ci/docs-check

Leaf-Lin avatar Sep 23 '22 06:09 Leaf-Lin

I added this file to the table of contents so that it displays in the navigation. I also made changes to the introductory section, but I have questions about how this tutorial works. We make a lot of assumptions in this document. For example, the first step says:

  1. On the Clients side, pause ingestion of my_index into prod1.

TIP: Ensure no writes are occurring on the leader index (if the data centre is down, or cluster is unavailable, no action needed).

How do you pause ingestion? Through Kibana? If so, where? What is "the Clients side"? How can I tell if writes are occurring on the leader index or check the cluster's availability?

I don't think that we can assume users have all of this knowledge and instinctually know where to complete these tasks. We should be much more prescriptive and provide both direction (such as where to go in the Cloud console) and examples.

@Leaf-Lin, can you help to provide some additional context?

lockewritesdocs avatar Sep 23 '22 19:09 lockewritesdocs

I've made some changes to this doc including clarifying how to pause ingest on the client side and adding an image to clarify the 3 scenarios.

Preview page is available in: https://elasticsearch_87099.docs-preview.app.elstc.co/guide/en/elasticsearch/reference/master/ccr-disaster-recovery-uni-directional-tutorial.html

Btw, I only changed this one page, but the https://elasticsearch_87099.docs-preview.app.elstc.co/diff shows a lot of changes, I hope that won't be merged.

Leaf-Lin avatar Nov 10 '22 04:11 Leaf-Lin

❌ Author of the following commits did not sign a Contributor Agreement: 2a36acde312cebc758fc819f92c61d90b8e2ed0e, 0cda1b72cfd73a277fce2443419968caa6987b75

Please, read and sign the above mentioned agreement if you want to contribute to this project

Closing this in favour of https://github.com/elastic/elasticsearch/pull/91491

Leaf-Lin avatar Nov 30 '22 11:11 Leaf-Lin