Add more details to Upgrade assistant API docs #63862
Labels
bug
Fixes for quality problems that affect the customer experience
Feature:Upgrade Assistant
needs_docs
Team:Kibana Management
Dev Tools, Index Management, Upgrade Assistant, ILM, Ingest Node Pipelines, and more
Kibana version: 7.7.0
Elasticsearch version: 7.7.0
Describe the bug: Upgrade assistant API docs should describe more details.
https://www.elastic.co/guide/en/kibana/7.7/upgrade-assistant-api.html
They should say that your original index will be deleted at the end of the reindexing and that an alias will be created with the original index name and pointing to the new index.
Does the index get locked for writes, and/or reads during the reindex? Maybe the Kibana reindex API uses an underlying Elasticsearch reindex API and these details are covered there? A user might assume they can continue writing and reading from the index during the reindex and that the replacement of the original index with the alias is atomic. I don't know if that's true or not.
Our APIs should document what privileges are required. This is a pretty widespread problem and doesn't have to be addressed as part of this issue. This operation might typically be performed by a superuser even if we documented specific privs required.
The text was updated successfully, but these errors were encountered: