Skip to content

[DOCS] Add note that write indices are not replicated #82997

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 3 commits into from
Jan 28, 2022
Merged

[DOCS] Add note that write indices are not replicated #82997

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ede1fe8
[DOCS] Add note that write indices are not replicated
Jan 24, 2022
9b5260f
Clarify note about is_write_index
Jan 28, 2022
d59bda2
Clarify leader aliases with is_write_index
Jan 28, 2022
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
4 changes: 4 additions & 0 deletions docs/reference/ccr/index.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,10 @@ You can't manually modify a follower index's mappings or aliases. To make
changes, you must update the leader index. Because they are read-only, follower
indices reject writes in all configurations.

NOTE: Although changes to aliases on the leader index are replicated to follower
indices, write indices are ignored. Follower indices can't accept direct writes,
so any indices where `is_write_index` is `true` are not replicated.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so any indices where is_write_index is true are not replicated.

@DaveCTurner, should this be "any indices" or "any index aliases"?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The indices are replicated, only the information on the alias about is_write_index is not, that flag is always forced to false on the follower.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The indices are replicated, only the information on the alias about is_write_index is not, that flag is always forced to false on the follower.

Thanks for the explanation @henningandersen! I updated the note text in 9b5260f -- let me know if that's accurate.


For example, you index a document named `doc_1` in Datacenter A, which
replicates to Datacenter B. If a client connects to Datacenter B and attempts
to update `doc_1`, the request fails. To update `doc_1`, the client must
Expand Down