Link Search Menu Expand Document Documentation Menu

Migration Assistant icon Migration Assistant for OpenSearch

Migration Assistant is the Kubernetes-native migration platform for moving data, metadata, and live traffic from Elasticsearch, OpenSearch, and Apache Solr to OpenSearch.

The Migration Assistant operating model is:

  • You define the migration in workflow configuration.
  • Migration Assistant runs the work on Kubernetes.
  • You use the Migration Console and Workflow CLI to submit, observe, approve, validate, and switch traffic to the target.

Migration Assistant runs on any Kubernetes distribution. Two choices are independent: where Migration Assistant runs and what you migrate to. Where it runs can be a managed-cloud path, such as Amazon EKS on AWS or Google Kubernetes Engine (GKE) on GCP, or any other Kubernetes platform. Each managed-cloud path supplies the identity, image, snapshot, and observability integrations that you typically need for a real migration.

Key capabilities

Migration Assistant provides the following:

  • One migration model for snapshot-based migrations with planned downtime (called backfill-only) and zero-downtime migrations that use live-traffic Capture and Replay.
  • Repeatable workflows instead of one-time infrastructure choreography.
  • Low source-cluster impact through snapshot-based backfill with Reindex-from-Snapshot (RFS).
  • Operational checkpoints through approval gates, logs, status views, and validation steps.
  • Practical managed-cloud paths (Amazon EKS on AWS and GKE on GCP) that reduce surrounding platform work.

Getting started

  1. Decide whether Migration Assistant is the right tool.
  2. Understand why Migration Assistant runs on Kubernetes and how the managed-cloud paths fit in.
  3. Assess your migration. Review breaking changes, downtime constraints, and required transformations.
  4. Choose your deployment path.
  5. Learn how a migration runs.
  6. Use the Workflow CLI and then pick a playbook.

Looking for the older ECS deployment model? See the classic Migration Assistant documentation.

1

Decide whether Migration Assistant fits your migration path, downtime target, and operational model.

2

The philosophy behind Migration Assistant and the recommended managed-cloud paths on AWS and GCP.

3

Compare Amazon EKS, GKE, and other Kubernetes platforms, and decide which path fits your environment.

4

The workflow-driven lifecycle for backfill, Capture and Replay, validation, and cutover.

5

Use the Workflow CLI as the primary interface for configuring, submitting, and managing migrations.

6

Follow path-specific guides for common source and target combinations.

350 characters left

Have a question? .

Want to contribute? or .