Migration Assistant updates and feedback (opensearch-project#10020)

* Migration Assistant updates and feedback.

Signed-off-by: Archer <[email protected]>

* Remove cruft from other MAT branch

Signed-off-by: Archer <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

---------

Signed-off-by: Archer <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

Author: Naarcha-AWS

_data/migration-assistant/valid_migrations.yml

@@ -1,33 +1,37 @@
 # Migration paths for Migration Assistant
 migration_paths:
-  - source: "Elasticsearch 5.6"
+  - source: "Elasticsearch 5.x"
     targets: 
-      - "OpenSearch 1.3"
-      - "OpenSearch 2.19"
-      - "OpenSearch 3.0"
-  - source: "Elasticsearch 6.8"
+      - "OpenSearch 1.x"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "Elasticsearch 6.x"
     targets:
-      - "OpenSearch 1.3"
-      - "OpenSearch 2.19"
-      - "OpenSearch 3.0"
-  - source: "Elasticsearch 7.10"
+      - "OpenSearch 1.x"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "Elasticsearch 7.x"
     targets:
-      - "OpenSearch 1.3"
-      - "OpenSearch 2.19"
-      - "OpenSearch 3.0"
-  - source: "Elasticsearch 7.17"
+      - "OpenSearch 1.x"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "Elasticsearch 7.x"
     targets:
-      - "OpenSearch 1.3"
-      - "OpenSearch 2.19"
-      - "OpenSearch 3.0"
-  - source: "OpenSearch 1.3"
+      - "OpenSearch 1.x"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "Elasticsearch 8.x"
     targets:
-      - "OpenSearch 2.19"
-      - "OpenSearch 3.0"
-  - source: "OpenSearch 2.19"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "OpenSearch 1.x"
     targets:
-      - "OpenSearch 2.19"
-      - "OpenSearch 3.0"
-  - source: "OpenSearch 3.0"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "OpenSearch 2.x"
     targets:
-      - "OpenSearch 3.0"
+      - "OpenSearch 2.x"
+      - "OpenSearch 3.x"
+  - source: "OpenSearch 3.x"
+    targets:
+      - "OpenSearch 3.x"

_migration-assistant/deploying-migration-assistant/configuration-options.md

@@ -166,7 +166,7 @@ Both the source and target cluster can use no authentication, authentication lim
 ```
 {% include copy.html %}
 
-The `serviceSigningName` can be `es` for an Elasticsearch or OpenSearch domain, or `aoss` for an OpenSearch Serverless collection.
+The `serviceSigningName` can be `es` for an Elasticsearch or OpenSearch domain.
 
 All of these authentication options apply to both source and target clusters.
 

_migration-assistant/deploying-migration-assistant/getting-started-data-migration.md

@@ -4,7 +4,6 @@ title: Getting started with data migration
 parent: Deploying Migration Assistant
 nav_order: 10
 redirect_from:
-  - /upgrade-to/upgrade-to/
   - /upgrade-to/snapshot-migrate/
   - /migration-assistant/getting-started-with-data-migration/
 ---

_migration-assistant/index.md

@@ -10,6 +10,7 @@ redirect_from:
   - /migration-assistant/index/
   - /upgrade-to/index/
   - /upgrade-to/
+  - /upgrade-to/upgrade-to/
 ---
 
 # Migration Assistant for OpenSearch
@@ -69,7 +70,7 @@ The design deployed in AWS is as follows:
 1. Client traffic is directed to the existing cluster.
 2. An Application Load Balancer with capture proxies relays traffic to a source while replicating data to Amazon Managed Streaming for Apache Kafka (Amazon MSK).
 3. Using the migration console, you can initiate metadata migration to establish indexes, templates, component templates, and aliases on the target cluster.
-4. With continuous traffic capture in place, you can use a `reindex-from-snapshot` process to capture data from your current index.
+4. With continuous traffic capture in place, you can use a `Reindex-from-Snapshot` process to capture data from your current index.
 4. Once `Reindex-from-Snapshot` is complete, captured traffic is replayed from Amazon MSK to the target cluster by the traffic replayer.
 5. Performance and behavior of traffic sent to the source and target clusters are compared by reviewing logs and metrics.
 6. After confirming that the target cluster's functionality meets expectations, clients are redirected to the new target.

_migration-assistant/is-migration-assistant-right-for-you.md

@@ -48,6 +48,10 @@ There are also tools available for migrating cluster configuration, templates, a
   </tbody>
 </table>
 
+### Future migration paths
+
+To see the OpenSearch migrations roadmap, go to [OpenSearch Migrations - Roadmap](https://github.com/orgs/opensearch-project/projects/229/views/1).
+
 ### Supported source and target platforms
 
 The following source and target platforms are supported:
@@ -74,7 +78,7 @@ Migration Assistant supports the following AWS Regions:
 - AWS GovCloud (US-East)[^1]
 - AWS GovCloud (US-West)[^1]
 
-[^1]: GovCloud does not support `reindex-from-snapshot` (RFS) shard sizes above 80 GiB. Ensure your shard sizes are within this limit when planning migrations with RFS in the listed GovCloud regions.
+[^1]: GovCloud does not support `Reindex-from-Snapshot` (RFS) shard sizes above 80 GiB. Ensure your shard sizes are within this limit when planning migrations with RFS in the listed GovCloud regions.
 
 ### Future migration paths
 
@@ -86,13 +90,15 @@ Before starting a migration, consider the scope of the components involved. The
 
 | Component | Supported | Recommendations   |
 | :--- |:--- | :--- |
-| **Documents**  | Yes  | Migrate existing data with `reindex-from-snapshot` (RFS) and live traffic with Capture and Replay. |
-| **Index settings**  | Yes   | Migrate with the metadata migration tool. |
-| **Index mappings**  | Yes   | Migrate with the metadata migration tool.  |
-| **Index templates**   | Yes   | Migrate with the metadata migration tool. |
-| **Component templates**  | Yes   | Migrate with the metadata migration tool.  |
-| **Aliases**   | Yes   | Migrate with the metadata migration tool.  |
-| **Index State Management (ISM) policies**  | Expected in 2025    | Manually migrate using an API.  |
-| **Elasticsearch Kibana dashboards** | Expected in 2025 | This tool is only needed when used to migrate Elasticsearch Kibana Dashboards to OpenSearch Dashboards. To start, export JSON files from Kibana and import them into OpenSearch Dashboards; before importing, use the [`dashboardsSanitizer`](https://github.com/opensearch-project/opensearch-migrations/tree/main/dashboardsSanitizer) tool on X-Pack visualizations like Canvas and Lens in Kibana Dashboards, as they may require recreation for compatibility with OpenSearch. |
+| **Documents**  | Yes  | Migrate existing data with `Reindex-from-Snapshot` (RFS) and live traffic with Capture and Replay. |
+| **Index settings**  | Yes   | Migrate with the `Metadata-Migration-Tool`. |
+| **Index mappings**  | Yes   | Migrate with the `Metadata-Migration-Tool`.  |
+| **Index templates**   | Yes   | Migrate with the `Metadata-Migration-Tool`. |
+| **Component templates**  | Yes   | Migrate with the `Metadata-Migration-Tool`.  |
+| **Aliases**   | Yes   | Migrate with the `Metadata-Migration-Tool`.  |
+| **Index State Management (ISM) policies**  | Expected in 2025    | Manually migrate using an API. For more information about ISM support, see [issue #944](https://github.com/opensearch-project/opensearch-migrations/issues/944). |
+| **Elasticsearch (Kibana)[^2] dashboards** | Expected in 2025 | This tool is only needed when used to migrate Elasticsearch Kibana Dashboards to OpenSearch Dashboards. To start, export JSON files from Kibana and import them into OpenSearch Dashboards. For Elasticsearch versions Elasticsearch 7.10.2 to 7.17, use the [`dashboardsSanitizer`](https://github.com/opensearch-project/opensearch-migrations/tree/main/dashboardsSanitizer) tool before importing X-Pack visualizations like Canvas and Lens in Kibana Dashboards, as they may require recreation for compatibility with OpenSearch.|
 | **Security constructs**   | No   | Configure roles and permissions based on cloud provider recommendations. For example, if using AWS, leverage AWS Identity and Access Management (IAM) for enhanced security management. |
 | **Plugins**  | No  | Check plugin compatibility; some Elasticsearch plugins may not have direct OpenSearch equivalents. |
+
+[^2]: Kibana 5.0--7.10.2 will be supported with Elasticsearch Kibana to OpenSearch Dashboards Support on all supported source paths. Kibana 8+ is unsupported. For more information, see [issue #944](https://github.com/opensearch-project/opensearch-migrations/issues/944).