Skip to main content

AWS Solutions Library

Migration Assistant for Amazon OpenSearch Service

Flexible multi-version workload migration with rollback capability and no downtime

Open guide
Go to source code

Overview

Migration Assistant for Amazon OpenSearch Service assists you in migrating or upgrading your Elasticsearch and OpenSearch workloads to Amazon OpenSearch Service managed clusters. This AWS Solution automates manual tasks with a low-risk and prescriptive migration path for existing and live data. It also includes advanced features, such as a metadata migration tool and capture and replay comparison tooling to help you identify potential migration and upgrade issues earlier. The migration process is streamlined, performance and behavioral comparisons based on real customer workloads are enabled, and the pre-migration, migration, and validation phases are accelerated.

This solution prescribes a systematic migration workflow to upgrade, migrate, recover, and modify an OpenSearch Service cluster. The workflow includes a migration console command line interface (CLI) for management, a dedicated scaling group for existing data backfill, and a replayer to synchronize live traffic between source and target clusters. Users can pause or abort the migration without affecting production traffic, thereby reducing risk. Additionally, the backfill functionality minimizes further risk by retrieving data from a snapshot, leaving the source cluster unaffected, and supporting multi-hop migrations, which decreases the overall number of migrations required.

Benefits

Transfer data from an originating (source) cluster to a designated target (OpenSearch Service cluster).

Safely capture and replay traffic on source and target clusters to identify optimal performance while reducing migration risk through abort capabilities, comparison tools, source preservation, and multi-hop support.
Record requests and responses between the source and destination clusters for comparison, then forward the latency metrics and response codes to an analytics hub. You can analyze the data essential for transitioning your traffic from a legacy system to a new OpenSearch Service destination.

How it works

You can automatically deploy this architecture using the implementation guide and the accompanying AWS CloudFormation template.

Open implementation guide

About this deployment

  • Version: 2.5.0
  • Released: 8/2025
  • Author: AWS
  • Est. deployment time: 45-60 mins
  • Estimated cost: See details

Deploy with confidence

Everything you need to launch this AWS Solution in your account is right here

We'll walk you through it

Get started fast. Read the implementation guide for deployment steps, architecture details, cost information, and customization options.

Open guide

Let's make it happen

Ready to deploy? Open the CloudFormation template in the AWS Console to begin setting up the infrastructure you need. You'll be prompted to access your AWS account if you haven't yet logged in. 

Launch in the AWS Console: