summaryrefslogtreecommitdiff
path: root/docs/reference/ingest.asciidoc
diff options
context:
space:
mode:
authorBoaz Leskes <b.leskes@gmail.com>2017-09-14 21:25:02 +0300
committerGitHub <noreply@github.com>2017-09-14 21:25:02 +0300
commit1ca0b5e9e46e29b884a32b45f52fb08d07f7cbf2 (patch)
tree956e8c5c48c5fe8224e529b20dc6ca159402ab0b /docs/reference/ingest.asciidoc
parente69c39a60f8dbac13313eba78097898840099131 (diff)
Introduce a History UUID as a requirement for ops based recovery (#26577)
The new ops based recovery, introduce as part of #10708, is based on the assumption that all operations below the global checkpoint known to the replica do not need to be synced with the primary. This is based on the guarantee that all ops below it are available on primary and they are equal. Under normal operations this guarantee holds. Sadly, it can be violated when a primary is restored from an old snapshot. At the point the restore primary can miss operations below the replica's global checkpoint, or even worse may have total different operations at the same spot. This PR introduces the notion of a history uuid to be able to capture the difference with the restored primary (in a follow up PR). The History UUID is generated by a primary when it is first created and is synced to the replicas which are recovered via a file based recovery. The PR adds a requirement to ops based recovery to make sure that the history uuid of the source and the target are equal. Under normal operations, all shard copies will stay with that history uuid for the rest of the index lifetime and thus this is a noop. However, it gives us a place to guarantee we fall back to file base syncing in special events like a restore from snapshot (to be done as a follow up) and when someone calls the truncate translog command which can go wrong when combined with primary recovery (this is done in this PR). We considered in the past to use the translog uuid for this function (i.e., sync it across copies) and thus avoid adding an extra identifier. This idea was rejected as it removes the ability to verify that a specific translog really belongs to a specific lucene index. We also feel that having a history uuid will serve us well in the future.
Diffstat (limited to 'docs/reference/ingest.asciidoc')
0 files changed, 0 insertions, 0 deletions