diff --git a/manage-data/lifecycle/index-lifecycle-management/manage-existing-indices.md b/manage-data/lifecycle/index-lifecycle-management/manage-existing-indices.md index 6ab39588bd..139176dbca 100644 --- a/manage-data/lifecycle/index-lifecycle-management/manage-existing-indices.md +++ b/manage-data/lifecycle/index-lifecycle-management/manage-existing-indices.md @@ -1,15 +1,18 @@ --- +navigation_title: Migrate to {{ilm-init}} (self-managed and ECK) mapped_pages: - https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-with-existing-indices.html applies_to: - stack: ga + deployment: + self: ga + eck: ga products: - id: elasticsearch --- -# Manage existing indices [ilm-with-existing-indices] +# Migrate to {{ilm-init}} on self-managed and {{eck}} deployments [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. diff --git a/manage-data/lifecycle/index-lifecycle-management/migrate-ilm.md b/manage-data/lifecycle/index-lifecycle-management/migrate-ilm.md new file mode 100644 index 0000000000..41dd34c85c --- /dev/null +++ b/manage-data/lifecycle/index-lifecycle-management/migrate-ilm.md @@ -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 another mechanism to manage the lifecycle of your indices. To help you adapt your existing indices to use {{ilm}}, a few guides are available: + +[](/manage-data/lifecycle/index-lifecycle-management/migrate-index-management.md) {applies_to}`ess:` {applies_to}`ece:` +: Describes how to migrate {{es}} indices in an {{ech}} or {{ece}} deployment from using deprecated index curation or another periodic indices management mechanism to use {{ilm}}. + +[](/manage-data/lifecycle/index-lifecycle-management/manage-existing-indices.md) {applies_to}`self:` {applies_to}`eck:` +: Describes how to migrate {{es}} indices in a self-managed 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) {applies_to}`stack:` +: Describes how to migrate from using custom node attributes and attribute-based allocation filters to using built-in node roles, enabling {{ilm-init}} to automatically move indices between data tiers. + +If you are configuring {{ilm-init}} for new indices, refer to [](/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 [](/manage-data/lifecycle/index-lifecycle-management/policy-apply.md). \ No newline at end of file diff --git a/manage-data/lifecycle/index-lifecycle-management/migrate-index-management.md b/manage-data/lifecycle/index-lifecycle-management/migrate-index-management.md index c81a371a97..423ec049be 100644 --- a/manage-data/lifecycle/index-lifecycle-management/migrate-index-management.md +++ b/manage-data/lifecycle/index-lifecycle-management/migrate-index-management.md @@ -1,15 +1,19 @@ --- +navigation_title: Migrate to {{ilm-init}} (ECH or ECE) 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 + deployment: + ece: ga + ess: ga products: - id: cloud-enterprise - id: cloud-hosted --- -# Migrate to index lifecycle management +# Migrate to {{ilm-init}} on {{ech}} or {{ece}} deployments ::::{important} Index curation is deprecated. Any deployments using index curation are prompted to migrate to ILM. @@ -17,7 +21,7 @@ Index curation is deprecated. Any deployments using index curation are prompted The index lifecycle management (ILM) feature of the {{stack}} provides an integrated and streamlined way to manage time-based data, making it easier to follow best practices for managing your indices. Compared to index curation, migrating to ILM gives you more fine-grained control over the lifecycle of each index. -For existing hot-warm deployments that are currently using index curation, there are a couple of options for migrating to index lifecycle management (ILM). You can: +For existing {{ecloud}} hot-warm deployments that are currently using index curation, there are a couple of options for migrating to index lifecycle management (ILM). You can: * Use the migration process in the console to change an existing deployment to ILM. * Take a snapshot and restore your data to a new Elastic Stack deployment that has ILM enabled. diff --git a/manage-data/toc.yml b/manage-data/toc.yml index 6b2d647e20..62bc0732f3 100644 --- a/manage-data/toc.yml +++ b/manage-data/toc.yml @@ -134,8 +134,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