Skip to content

Update Migration Assistant docs for OpenSearch Serverless NextGen#12489

Open
jugal-chauhan wants to merge 3 commits into
opensearch-project:mainfrom
jugal-chauhan:serverless-nextgen-rename
Open

Update Migration Assistant docs for OpenSearch Serverless NextGen#12489
jugal-chauhan wants to merge 3 commits into
opensearch-project:mainfrom
jugal-chauhan:serverless-nextgen-rename

Conversation

@jugal-chauhan

@jugal-chauhan jugal-chauhan commented May 29, 2026

Copy link
Copy Markdown
Contributor

Description

Updates the Migration Assistant section to reflect Amazon OpenSearch Serverless NextGen GA.

NextGen is the new default architecture for Amazon OpenSearch Serverless. Existing docs were written for the Classic architecture only and don't mention collection groups, the new endpoint format, or the inheritance model. This PR pivots the Serverless content across the Migration Assistant tree so users following the playbooks land on a working NextGen migration path.

Key changes

  • Added "Amazon OpenSearch Serverless NextGen" to Vale accept texts.
  • Renamed all references from Amazon OpenSearch Serverless to Amazon OpenSearch Serverless NextGen across all migration-assistant pages (full form on first use per page, then Serverless NextGen for brevity).
  • Updated the example collection endpoint format from <id>.<region>.aoss.amazonaws.com to <id>.aoss.<region>.on.aws (the NextGen format).
  • Added a new "Create the collection group" prerequisite step to the AOS-to-AOSS playbook, since collection groups are required for NextGen.
  • Updated the create-collection command in that playbook to include --collection-group-name. Generation is inherited from the parent collection group, so no --generation flag on create-collection.

URL preservation

Permalinks (/migration-assistant/amazon-opensearch-serverless/ and /migration-assistant/playbook-amazon-opensearch-service-to-serverless/) are unchanged so existing external links keep resolving. Only link text and page titles have been updated.

Testing

The end-to-end migration path described in the updated playbooks was validated on a live NextGen SEARCH collection - a sample Apache Solr 8.11 source was successfully backfilled into a NextGen collection using Migration Assistant, including collection-group creation, metadata translation, and document indexing.

Issues Resolved

N/A

Version

N/A

Frontend features

If you're submitting documentation for an OpenSearch Dashboards feature, add a video that shows how a user will interact with the UI step by step. A voiceover is optional.

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

@github-actions

Copy link
Copy Markdown

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference).

@github-actions github-actions Bot added the In progress Issue/PR: The issue or PR is in progress. label May 29, 2026
@jugal-chauhan jugal-chauhan changed the title Pivot Migration Assistant docs to OpenSearch Serverless NextGen Update Migration Assistant docs for OpenSearch Serverless NextGen Jun 1, 2026
@jugal-chauhan jugal-chauhan marked this pull request as ready for review June 1, 2026 15:01
@github-actions github-actions Bot added Tech review PR: Tech review in progress and removed In progress Issue/PR: The issue or PR is in progress. labels Jun 1, 2026
@jugal-chauhan jugal-chauhan force-pushed the serverless-nextgen-rename branch from 3061889 to f39c726 Compare June 2, 2026 16:04
Signed-off-by: Jugal Chauhan <jugaldc@amazon.com>
Signed-off-by: Jugal Chauhan <jugaldc@amazon.com>
@jugal-chauhan jugal-chauhan force-pushed the serverless-nextgen-rename branch from 70f6227 to 3e5b02f Compare June 2, 2026 16:37
Signed-off-by: Jugal Chauhan <jugaldc@amazon.com>
@kolchfa-aws

Copy link
Copy Markdown
Collaborator

@jugal-chauhan Is this PR ready for doc review?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 3.7 Tech review PR: Tech review in progress

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants