Skip to content
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.

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

[DOCS] Document how to switch ILM policies #73967

Merged
merged 2 commits into from
Jun 28, 2021
Merged

[DOCS] Document how to switch ILM policies #73967

merged 2 commits into from
Jun 28, 2021

Conversation

jrodewig
Copy link
Contributor

@jrodewig jrodewig commented Jun 9, 2021

To switch an index's lifecycle policy, you must first remove the existing policy. Otherwise, phase execution for the index may silently fail.

Closes #70151

Preview

To switch an index's lifecycle policy, you must first remove the existing
policy. Otherwise, phase execution for the index may silently fail.

Closes #70151
@jrodewig jrodewig marked this pull request as ready for review June 10, 2021 13:57
@jrodewig jrodewig requested a review from andreidan June 10, 2021 13:57
@jrodewig jrodewig added :Data Management/ILM+SLM Index and Snapshot lifecycle management >docs General docs changes v7.13.2 v7.14.0 v8.0.0 labels Jun 10, 2021
@elasticmachine elasticmachine added Team:Data Management Meta label for data/management team Team:Docs Meta label for docs team labels Jun 10, 2021
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-core-features (Team:Core/Features)

@elasticmachine
Copy link
Collaborator

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

Copy link
Contributor

@andreidan andreidan left a comment

Choose a reason for hiding this comment

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

Thanks James, this LGTM.

Would it make sense to add a big warning that the remove policy API removes the policy (and all the ILM metadata) immediately without any consideration w.r.t where the index is in its lifecycle (mid-action executing for eg.) - it's the equivalent of kill -9. As an example - it could happen that for an index that is in the forcemerge action (a forcemerge action that changes the compression codec closes and reopens the index) after removing the policy using the API the index is closed.
So maybe besides a warning we should advise a manual/visual review of the index state before assigning a new policy?

@jrodewig
Copy link
Contributor Author

Thanks @andreidan. I added a middle step to cover your suggestion.

@jrodewig
Copy link
Contributor Author

@elasticmachine run elasticsearch-ci/docs

@jrodewig jrodewig merged commit 0c205b0 into elastic:master Jun 28, 2021
@jrodewig jrodewig deleted the docs__switch-ilm-policy branch June 28, 2021 14:32
jrodewig added a commit that referenced this pull request Jun 28, 2021
To switch an index's lifecycle policy, you must first remove the existing
policy. Otherwise, phase execution for the index may silently fail.

Closes #70151
jrodewig added a commit that referenced this pull request Jun 28, 2021
To switch an index's lifecycle policy, you must first remove the existing
policy. Otherwise, phase execution for the index may silently fail.

Closes #70151
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:Data Management/ILM+SLM Index and Snapshot lifecycle management >docs General docs changes Team:Data Management Meta label for data/management team Team:Docs Meta label for docs team v7.13.3 v7.14.0 v8.0.0-alpha1
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Changing the ILM policy for a managed index is non-deterministic
5 participants