OpenSearch/docs/reference
Tal Levy 1e0fcebfe1
update rollover to leverage write-alias semantics (#32216)
Rollover should not swap aliases when `is_write_index` is set to `true`.
Instead, both the new and old indices should have the rollover alias,
with the newly created index as the new write index

Updates Rollover to leverage the ability to preserve aliases and swap which is the write index.

Historically, Rollover would swap which index had the designated alias for writing documents against. This required users to keep a separate read-alias that enabled reading against both rolled over and newly created indices, whiles the write-alias was being re-assigned at every rollover.

With the ability for aliases to designate a write index, Rollover can be a bit more flexible with its use of aliases.

Updates include:

- Rollover validates that the target alias has a write index (the index that is being rolled over). This means that the restriction that aliases only point to one index is no longer necessary.
- Rollover explicitly (and atomically) swaps which index is the write-index by explicitly assigning the existing index to have `is_write_index: false` and have the newly created index have its rollover alias as `is_write_index: true`. This is only done when `is_write_index: true` on the write index. Default behavior of removing the alias from the rolled over index stays when `is_write_index` is not explicitly set

Relevant things that are staying the same:

- Rollover is rejected if there exist any templates that match the newly-created index and configure the rollover-alias
   - I think this existed to prevent the situation where an alias pointed to two indices for a short while. Although this can technically be relaxed, the specific cases that are safe are really particular and difficult to reason, so leaving the broad restriction sounds good
2018-07-30 14:32:55 -07:00
..
aggregations Docs: Correcting a typo in tophits (#32359) 2018-07-26 13:30:01 -04:00
analysis Add exclusion option to `keep_types` token filter (#32012) 2018-07-17 09:04:41 +02:00
cat Docs: Use the default distribution to test docs (#31251) 2018-06-18 12:06:42 -04:00
cluster Update update-settings.asciidoc (#31378) 2018-07-26 17:16:53 +02:00
commands [DOCS] Moves commands to docs folder (#31114) 2018-06-06 07:49:15 -07:00
docs Docs: Explain _bulk?refresh shard targeting 2018-07-05 16:24:03 -04:00
how-to Use correct formatting for links (#29460) 2018-07-16 21:11:24 +02:00
images Docs/windows installer (#27369) 2017-11-15 21:35:54 +11:00
index-modules Remove reference to non-existent store type (#32418) 2018-07-27 11:24:03 -04:00
indices update rollover to leverage write-alias semantics (#32216) 2018-07-30 14:32:55 -07:00
ingest INGEST: Extend KV Processor (#31789) (#32232) 2018-07-20 22:32:50 +02:00
licensing [DOCS] Fix licensing API details (#31667) 2018-06-28 15:38:41 -07:00
mapping Ensure that field aliases cannot be used in multi-fields. (#32219) 2018-07-20 00:18:54 -07:00
migration Remove aliases resolution limitations when security is enabled (#31952) 2018-07-20 09:23:32 +02:00
modules Remove indication of future multi-homing support (#32187) 2018-07-19 11:33:46 +01:00
monitoring [DOCS] Move monitoring to docs folder (#31477) 2018-06-22 15:39:34 -07:00
query-dsl Update Fuzzy Query docs to clarify default behavior re max_expansions (#30819) 2018-07-30 13:19:26 -07:00
release-notes Percentile/Ranks should return null instead of NaN when empty (#30460) 2018-06-18 10:01:28 -04:00
rest-api [DOCS] Move migration APIs to docs (#31473) 2018-06-21 08:19:23 -07:00
search Add ERR to ranking evaluation documentation (#32314) 2018-07-24 19:58:34 +02:00
settings [DOCS] Adds recommendation for xpack.security.enabled (#32345) 2018-07-25 09:51:40 -07:00
setup Remove reference to non-existent store type (#32418) 2018-07-27 11:24:03 -04:00
sql SQL: Remove restriction for single column grouping (#31818) 2018-07-06 20:55:27 +03:00
testing [Docs] Use capital letters in section headings (#31678) 2018-06-29 11:58:39 +02:00
upgrade [DOCS] Clarified that you must remove X-Pack plugin when upgrading from pre-6.3. (#32016) 2018-07-20 14:17:48 -07:00
aggregations.asciidoc [Docs] Update aggregations.asciidoc (#29265) 2018-03-28 15:01:45 +02:00
analysis.asciidoc [Docs] Add clarification to analysis example (#31826) 2018-07-06 14:36:58 +02:00
api-conventions.asciidoc Default to one shard (#30539) 2018-05-14 12:22:35 -04:00
cat.asciidoc Rename the bulk thread pool to write thread pool (#29593) 2018-04-19 08:18:58 -04:00
cluster.asciidoc rest-high-level: added get cluster settings (#31706) 2018-07-02 13:25:17 -04:00
docs.asciidoc Inclusion of link to Multi Delete (#22619) 2017-01-16 12:58:59 +01:00
getting-started.asciidoc DOCS: put LIMIT 10 to the SQL query (#32065) 2018-07-16 16:09:56 -04:00
glossary.asciidoc Default to one shard (#30539) 2018-05-14 12:22:35 -04:00
gs-index.asciidoc [DOCS] Adding index file for GS "mini book". 2017-07-18 13:44:08 -07:00
how-to.asciidoc Correct grammar in list in how-to docs 2017-01-17 20:57:22 -05:00
index-modules.asciidoc Document woes between auto-expand-replicas and allocation filtering (#30531) 2018-05-14 12:14:37 +02:00
index.asciidoc [DOCS] Move sql to docs (#31474) 2018-06-22 15:40:25 -07:00
index.x.asciidoc [DOCS] Removes redundant index.asciidoc files (#30707) 2018-05-18 11:05:40 -07:00
indices.asciidoc add split index reference in indices.asciidoc 2017-11-06 12:55:41 +01:00
ingest.asciidoc [Docs] Changes to ingest.asciidoc (#28212) 2018-01-16 09:36:19 +01:00
mapping.asciidoc Add support for field aliases. (#32172) 2018-07-18 09:33:09 -07:00
modules.asciidoc Remove left-over tribe reference 2018-01-30 21:44:21 +01:00
query-dsl.asciidoc Update query-dsl.asciidoc (#27669) 2017-12-11 18:06:08 +01:00
redirects.asciidoc [Docs] Clarify `fuzzy_like_this` redirect (#30183) 2018-05-02 11:45:37 +02:00
release-notes.asciidoc Migrate migration docs from 6.0 to 7.0 (#26227) 2017-08-16 13:12:44 -06:00
search.asciidoc Move search concurrency and parallelism paragraphs 2018-02-26 07:47:57 -08:00
setup.asciidoc [DOCS] Starting Elasticsearch (#31701) 2018-07-03 13:40:37 -07:00
testing.asciidoc [Docs] Unify spelling of Elasticsearch (#27567) 2017-11-29 09:44:25 +01:00
upgrade.asciidoc Revert "[DOCS] Added 6.3 info & updated the upgrade table. (#30940)" 2018-06-11 22:04:36 -04:00