View a markdown version of this page

Playbook: Apache Solr 8.x or 9.x to OpenSearch 3.x - Migration Assistant for Amazon OpenSearch Service

Playbook: Apache Solr 8.x or 9.x to OpenSearch 3.x

This playbook is an end-to-end runbook for migrating an Apache Solr 8.x or 9.x deployment — either standalone (single-core) Solr or SolrCloud — into OpenSearch 3.x running on an Amazon OpenSearch Service domain or an Amazon OpenSearch Serverless NextGen collection. It strings the individual migration phases described in Configure and run workflows into one ordered sequence tailored to an Apache Solr source. For the general concepts behind a Solr migration, see Migrate from Apache Solr.

Important

This playbook’s main procedure is backup-based backfill. If you need zero-downtime migration for a SolrCloud source, add Capture and Replay so writes that arrive after the backup are captured and replayed to the target. Solr replay requires JSON-format write requests and Solr-specific transform provider configuration. Standalone Solr sources remain backfill-only.

This playbook assumes Migration Assistant is already deployed on Amazon Elastic Kubernetes Service (Amazon EKS). If you have not deployed it yet, complete Deploy the solution first. It also assumes you have confirmed the installed version with console --version and loaded the version-matched sample with workflow configure sample --load on the Migration Console pod (migration-console-0).