Skip to content

Create 'Migrate to ILM' landing page #2585

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

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ products:
- id: elasticsearch
---

# Manage existing indices [ilm-with-existing-indices]
# Migrate to {{ilm-init}} ({{stack}}) [ilm-with-existing-indices]

If you’ve been using Curator or some other mechanism to manage periodic indices, you have a couple options when [migrating to {{ilm-init}}](./migrate-index-management.md):
If you’ve been using Curator or some other mechanism to manage periodic indices, you have a couple of options when [migrating to {{ilm-init}}](./migrate-index-management.md):

* Set up your index templates to use an {{ilm-init}} policy to manage your new indices. Once {{ilm-init}} is managing your current write index, you can apply an appropriate policy to your old indices.
* Reindex into an {{ilm-init}}-managed index.
Expand Down
27 changes: 27 additions & 0 deletions manage-data/lifecycle/index-lifecycle-management/migrate-ilm.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
navigation_title: Migrate to {{ilm-init}}
mapped_pages:
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-migrate-index-management.html
- https://www.elastic.co/guide/en/cloud/current/ec-migrate-index-management.html
applies_to:
stack: ga
products:
- id: elasticsearch
- id: cloud-enterprise
- id: cloud-hosted
---

# Migrate to {{ilm-init}} [migrate-ilm]

You may already be using index curation, which is now deprecated, or another mechanism to manage the lifecycle of your indices. To help you adapt your existing indices from using earlier lifecycle mechanisms to use {{ilm}}, a few guides are available:

[](/manage-data/lifecycle/index-lifecycle-management/migrate-index-management.md)
: Describes how to migrate {{es}} indices in an {{ech}} or {{ece}} deployment from using deprecated index curation to use {{ilm}}.

[](/manage-data/lifecycle/index-lifecycle-management/manage-existing-indices.md)
: Describes how to migrate {{es}} indices in any {{stack}} environment from using deprecated index curation, or any other lifecycle mechanism, to use {{ilm}}.

[](/manage-data/lifecycle/index-lifecycle-management/migrate-index-allocation-filters-to-node-roles.md)
: Describes how to migrate from using custom node attributes and attribute-based allocation filters to move indices through data tiers in a hot-warm-cold architecture, to use {{ilm}}.

If you are configuring {{ilm-init}} for new indices, refer to [Configure a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md). If you plan to manually apply an {{ilm}} policy to existing indices that are not already using another type of lifecycle management, refer to [Manually apply a lifecycle policy to an index](/manage-data/lifecycle/index-lifecycle-management/policy-apply.md).
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ products:
- id: cloud-hosted
---

# Migrate to index lifecycle management
# Migrate to {{ilm-init}} ({{ecloud}})

::::{important}
Index curation is deprecated. Any deployments using index curation are prompted to migrate to ILM.
Expand Down
3 changes: 2 additions & 1 deletion manage-data/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -130,8 +130,9 @@ toc:
- file: lifecycle/index-lifecycle-management/restore-managed-data-stream-index.md
- file: lifecycle/index-lifecycle-management/tutorial-customize-built-in-policies.md
- hidden: lifecycle/index-lifecycle-management/index-management-in-kibana.md
- file: lifecycle/index-lifecycle-management/migrate-index-management.md
- file: lifecycle/index-lifecycle-management/migrate-ilm.md
children:
- file: lifecycle/index-lifecycle-management/migrate-index-management.md
- file: lifecycle/index-lifecycle-management/manage-existing-indices.md
- file: lifecycle/index-lifecycle-management/migrate-index-allocation-filters-to-node-roles.md
- file: lifecycle/data-stream.md
Expand Down
Loading