Skip to content

Commit 981ce4b

Browse files
committed
Review part 1
1 parent eb31d2f commit 981ce4b

File tree

2 files changed

+16
-30
lines changed

2 files changed

+16
-30
lines changed
Lines changed: 15 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,7 @@
11
---
2-
navigation_title: Migrate Elasticsearch data with minimal downtime
2+
navigation_title: Migrate with minimal downtime
33
applies_to:
44
stack: ga
5-
deployment:
6-
ess: ga
7-
ece: ga
8-
eck: ga
95
products:
106
- id: elasticsearch
117
- id: cloud-hosted
@@ -14,8 +10,7 @@ products:
1410
---
1511

1612
# Migrate {{es}} data with minimal downtime [migrate-elasticsearch-data-with-minimal-downtime]
17-
18-
When moving your data and services from one {{es}} cluster to another, such as to {{ech}}, {{ece}}, new on-premises hardware, or any other {{es}} environment, you can use incremental snapshots to minimize downtime.
13+
When moving your data and services from one {{es}} cluster to another, such as to {{ech}}, {{ece}}, new on-premises hardware, or any other {{es}} environment, you can migrate with minimal downtime using incremental snapshots.
1914

2015
Migrating with incremental snapshots is useful when you want to:
2116

@@ -24,61 +19,52 @@ Migrating with incremental snapshots is useful when you want to:
2419
* Maintain data consistency and minimize disruption.
2520

2621
## How incremental snapshots work [how-incremental-snapshots-work]
27-
2822
Incremental snapshots capture only the data that has changed since the previous snapshot.
2923

3024
After the initial full snapshot, each subsequent snapshot contains only the differences, which makes the snapshot process faster over time. When you restore snapshots, only the missing data segments are copied from the snapshot repository to the cluster local storage, speeding up restores when the changes between snapshots are small.
3125

3226
When you incrementally create and restore snapshots, you can repeatedly synchronize the new cluster with the old cluster by taking and restoring multiple snapshots before performing the final cutover. This mechanism enables you to copy the vast majority of your data into the new cluster ahead of time, making the future transition from the old cluster to your new one as quick as possible, since only few segments will need to go through the snapshot-and-restore procedure upon cutover.
3327

34-
## Recommended migration timeline [recommended-migration-timeline]
28+
## Incremental snapshot limitations [incremental-snapshot-limitations]
29+
While incremental snapshots allow efficient migration with minimal downtime, consider the limitations when planning your migration.
30+
31+
Limitations include the following:
32+
* **Storage requirements** – Sufficient repository storage is required, and usage can grow based on snapshot frequency and data volume.
33+
* **Network overhead** – Transferring snapshots across networks, regions, or providers can be time-consuming and incur costs.
34+
* **Version compatibility** – Old and new clusters must use compatible {{es}} versions. To check if your cluster versions are compatible, check [Snapshot version compatibility](/deploy-manage/tools/snapshot-and-restore.md#snapshot-restore-version-compatibility).
35+
* **Custom integrations** – Some custom integrations that directly use the {{es}} API, such as the [Elasticsearch Java Client library](elasticsearch-java://reference/index.md), can require additional handling during the cutover from the old cluster to the new cluster.
36+
* **Resource usage** – Initial and incremental snapshot and restore operations can be resource-intensive, potentially affecting cluster performance.
3537

36-
Complete the minimal-downtime migration using incremental snapshots. While the exact sequence may differ depending on your infrastructure and operational requirements, you can use the recommended migration timeline as a reliable baseline that you can adapt. Adjust the steps and times to fit your own operational needs.
38+
## Recommended migration timeline [recommended-migration-timeline]
39+
Tp complete the migration with minimal downtime, use incremental snapshots. While the exact sequence may differ depending on your infrastructure and operational requirements, you can use the recommended migration timeline as a reliable baseline that you can adapt. Adjust the steps and times to fit your own operational needs.
3740

3841
1. **09:00**: Take the initial full snapshot of the old cluster. You can also take the initial full snapshot the day before.
3942
2. **09:30**: Restore the snapshot to the new cluster.
4043
3. **09:55**: Take another snapshot of the old cluster and restore it to the new cluster. Repeat this process until the snapshot and restore operations take only a few seconds or minutes.
41-
4. **10:15**: Perform the final cutover:
44+
4. **10:15**: Perform the final cutover.
4245
1. In the old cluster, pause indexing or set indices to read-only.
4346
2. Take a final snapshot.
4447
3. Restore the snapshot to the new cluster.
4548
4. Change ingestion and querying to the new cluster.
4649
5. Open the indices in the new cluster.
4750

48-
## Incremental snapshot limitations [incremental-snapshot-limitations]
49-
50-
While incremental snapshots allow efficient migration with minimal downtime, consider the limitations when planning your migration.
51-
52-
Limitations include the following:
53-
* **Storage requirements** – Sufficient repository storage is required, and usage can grow based on snapshot frequency and data volume.
54-
* **Network overhead** – Transferring snapshots across networks, regions, or providers can be time-consuming and incur costs.
55-
* **Version compatibility** – Old and new clusters must use compatible {{es}} versions. To check if your cluster versions are compatible, check [Snapshot version compatibility](/deploy-manage/tools/snapshot-and-restore.md#snapshot-restore-version-compatibility).
56-
* **Custom integrations** – Some custom integrations that directly use the {{es}} API can require additional handling during the cutover from the old cluster to the new cluster.
57-
* **Resource usage** – Initial and incremental snapshot and restore operations can be resource-intensive, potentially affecting cluster performance.
58-
59-
## Additional topics [additional-incremental-snapshot-topics]
60-
51+
## Related resources [related-incremental-snapshot-resources]
6152
For more information on migrating {{es}} data with minimal downtime using incremental snapshots, review the related resources.
6253

6354
### Snapshot and restore
64-
6555
* For more information about snapshot and restore concepts, check [Snapshot and restore](/deploy-manage/tools/snapshot-and-restore.md).
6656
* To learn how to configure snapshot repositories before taking or restoring snapshots, check [Manage snapshot repositories](/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md).
6757
* To learn how to restore snapshots to clusters other than the source, check [Restore to a different cluster](/deploy-manage/tools/snapshot-and-restore/restore-snapshot.md#restore-different-cluster).
6858

6959
### Cluster and index management
70-
7160
* For details on setting indices to read-only to safely pause indexing during migration, check [Index lifecycle actions: Read-only](elasticsearch://reference/elasticsearch/index-lifecycle-actions/ilm-readonly.md).
7261

7362
### Data ingestion
74-
7563
* For information about using {{ls}} for data ingestion, check the [{{ls}} documentation](logstash://reference/index.md).
7664
* For information about using {{beats}} for data ingestion, check the [{{beats}} documentation](beats://reference/index.md).
7765

7866
### Alternative migration methods
79-
8067
* To learn about reindexing from remote clusters as an alternative migration method, check [Reindex from a remote cluster](/manage-data/migrate.md#ech-reindex-remote).
8168

8269
### Additional support
83-
8470
* To get expert assistance for your {{es}} migrations, go to [Elastic Professional Services](https://www.elastic.co/consulting).

manage-data/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ toc:
151151
- file: lifecycle/rollup/migrating-from-rollup-to-downsampling.md
152152
- file: migrate.md
153153
children:
154-
- file: migrate/migrate-data-between-elasticsearch-clusters-with-minimal-downtime.md
155154
- file: migrate/migrate-from-a-self-managed-cluster-with-a-self-signed-certificate-using-remote-reindex.md
156155
- file: migrate/migrate-internal-indices.md
156+
- file: migrate/migrate-data-between-elasticsearch-clusters-with-minimal-downtime.md
157157
- file: use-case-use-elasticsearch-to-manage-time-series-data.md

0 commit comments

Comments
 (0)