DOC-5183, DOC-5170, DOC-5192 Astra Migration Toolkit, Migration index page, more Sideloader integration and clean up

antora.yml

@@ -8,37 +8,52 @@ nav:
 
 asciidoc:
   attributes:
+    #General attributes
     company: 'DataStax'
-    product: 'Zero Downtime Migration'
-    product-short: 'ZDM'
-    product-proxy: 'ZDM Proxy'
-    product-utility: 'ZDM Utility'
-    product-automation: 'ZDM Proxy Automation'
-    product-demo: 'ZDM Demo Client'
-    dsbulk-migrator: 'DSBulk Migrator'
-    dsbulk-loader: 'DSBulk Loader'
+    support-url: 'https://support.datastax.com'
+    #Other product attributes
+    cass-reg: 'Apache Cassandra(R)'
     cass: 'Apache Cassandra'
     cass-short: 'Cassandra'
-    cass-reg: 'Apache Cassandra(R)'
-    cass-migrator: 'Cassandra Data Migrator'
-    cass-migrator-short: 'CDM'
     dse: 'DataStax Enterprise (DSE)'
     dse-short: 'DSE'
     hcd: 'Hyper-Converged Database (HCD)'
     hcd-short: 'HCD'
+    mc: 'Mission Control (MC)'
+    mc-short: 'MC'
+    mc-brief: 'Mission Control'
+    #Astra DB attributes
     astra-db: 'Astra DB'
     astra: 'Astra'
-    data-api: 'Data API'
     db-serverless: 'Serverless (Non-Vector)'
     db-serverless-vector: 'Serverless (Vector)'
     astra-ui: 'Astra Portal'
     astra-url: 'https://astra.datastax.com'
     astra-ui-link: '{astra-url}[{astra-ui}^]'
+    scb: 'Secure Connect Bundle (SCB)'
+    scb-short: 'SCB'
+    scb-brief: 'Secure Connect Bundle'
+    #Sideloader has a specific name in this repo. It is not identical to the one in the Serverless repo.
     sstable-sideloader: '{astra-db} Sideloader'
+    #devops api attributes
     devops-api: 'DevOps API'
     devops-api-ref-url: 'xref:astra-api-docs:ROOT:attachment$devops-api/index.html'
-    support-url: 'https://support.datastax.com'
-    mc: 'Mission Control (MC)'
-    mc-short: 'MC'
-
-#TODO: Bring SCB attributes
+    #data api attributes
+    data-api: 'Data API'
+    #Migration docs attributes
+    product: 'Zero Downtime Migration'
+    product-short: 'ZDM'
+    product-proxy: 'ZDM Proxy'
+    product-proxy-repo: 'https://github.com/datastax/zdm-proxy'
+    product-utility: 'ZDM Utility'
+    product-automation: 'ZDM Proxy Automation'
+    product-automation-repo: 'https://github.com/datastax/zdm-proxy-automation'
+    product-automation-shield: 'image:https://img.shields.io/github/v/release/datastax/zdm-proxy-automation?label=latest[alt="Latest zdm-proxy-automation release on GitHub",link="{product-automation-repo}/releases"]'
+    product-demo: 'ZDM Demo Client'
+    dsbulk-migrator: 'DSBulk Migrator'
+    dsbulk-migrator-repo: 'https://github.com/datastax/dsbulk-migrator'
+    dsbulk-loader: 'DSBulk Loader'
+    cass-migrator: 'Cassandra Data Migrator'
+    cass-migrator-short: 'CDM'
+    cass-migrator-repo: 'https://github.com/datastax/cassandra-data-migrator'
+    cass-migrator-shield: 'image:https://img.shields.io/github/v/release/datastax/cassandra-data-migrator?label=latest[alt="Latest cassandra-data-migrator release on GitHub",link="{cass-migrator-repo}/packages"]'

modules/ROOT/nav.adoc

@@ -1,54 +1,54 @@
+.Get started
+* xref:ROOT:components.adoc[]
+* xref:ROOT:zdm-proxy-migration-paths.adoc[]
+* Product-specific migration paths
+** xref:ROOT:astra-migration-paths.adoc[]
+** {dse-short} 6.9
+*** xref:6.9@dse:tooling:migration-path-dse.adoc[{dse-short} 6.9 migration tools]
+*** xref:6.9@dse:managing:operations/migrate-data.adoc[Migrate data to {dse-short} 6.9]
+** {dse-short} 6.8
+*** xref:6.8@dse:tooling:migration-path-dse.adoc[{dse-short} 6.8 migration tools]
+*** xref:6.8@dse:managing:operations/migrate-data.adoc[Migrate data to {dse-short} 6.8]
+** {dse-short} 5.1
+*** xref:5.1@dse:managing:operations/migrate-data.adoc[Migrate data to {dse-short} 5.1]
+** {mc-brief} migrations
+*** xref:mission-control:migrate:oss-cass-to-mission-control.adoc[Migrate {cass-short} clusters to {mc-short}]
+*** xref:mission-control:migrate:dse-to-mission-control.adoc[Migrate {dse-short} clusters to {mc-short}]
+
 .{product}
-* xref:introduction.adoc[]
-* xref:components.adoc[]
+* xref:ROOT:introduction.adoc[]
 * Planning
-** xref:preliminary-steps.adoc[]
-** xref:feasibility-checklists.adoc[]
-** xref:deployment-infrastructure.adoc[]
-** xref:create-target.adoc[]
-** xref:rollback.adoc[]
+** xref:ROOT:feasibility-checklists.adoc[]
+** xref:ROOT:deployment-infrastructure.adoc[]
+** xref:ROOT:create-target.adoc[]
+** xref:ROOT:rollback.adoc[]
 * Phase 1
-** xref:phase1.adoc[]
-** xref:setup-ansible-playbooks.adoc[]
-** xref:deploy-proxy-monitoring.adoc[]
-** xref:tls.adoc[]
-** xref:connect-clients-to-proxy.adoc[]
-** xref:metrics.adoc[]
-** xref:manage-proxy-instances.adoc[]
+** xref:ROOT:phase1.adoc[]
+** xref:ROOT:setup-ansible-playbooks.adoc[]
+** xref:ROOT:deploy-proxy-monitoring.adoc[]
+** xref:ROOT:tls.adoc[]
+** xref:ROOT:connect-clients-to-proxy.adoc[]
+** xref:ROOT:metrics.adoc[]
+** xref:ROOT:manage-proxy-instances.adoc[]
 * Phase 2
-** xref:migrate-and-validate-data.adoc[]
-** xref:cassandra-data-migrator.adoc[{cass-migrator}]
-** xref:dsbulk-migrator.adoc[{dsbulk-migrator}]
+** xref:ROOT:migrate-and-validate-data.adoc[]
+** xref:sideloader:sideloader-zdm.adoc[]
+** xref:ROOT:cassandra-data-migrator.adoc[]
+** xref:ROOT:dsbulk-migrator.adoc[]
 * Phase 3
-** xref:enable-async-dual-reads.adoc[]
+** xref:ROOT:enable-async-dual-reads.adoc[]
 * Phase 4
-** xref:change-read-routing.adoc[]
+** xref:ROOT:change-read-routing.adoc[]
 * Phase 5
-** xref:connect-clients-to-target.adoc[]
+** xref:ROOT:connect-clients-to-target.adoc[]
 * References
-** xref:troubleshooting-tips.adoc[]
-** xref:troubleshooting-scenarios.adoc[]
-** xref:contributions.adoc[]
-** xref:faqs.adoc[]
-** xref:glossary.adoc[]
-** https://github.com/datastax/zdm-proxy/releases[{product-proxy} release notes]
-** https://github.com/datastax/zdm-proxy-automation/releases[{product-automation} release notes]
-
-.{cass-migrator}
-* xref:cdm-overview.adoc[{cass-migrator}]
-* https://github.com/datastax/cassandra-data-migrator/releases[{cass-migrator-short} release notes]
-
-.{dsbulk-loader}
-* xref:dsbulk:overview:dsbulk-about.adoc[{dsbulk-loader}]
-* xref:dsbulk:installing:install.adoc[Installing {dsbulk-loader}]
-* Loading and unloading data
-** xref:dsbulk:getting-started:simple-load.adoc[Loading data without a configuration file]
-** xref:dsbulk:getting-started:simple-unload.adoc[Unloading data without a configuration file]
-** xref:dsbulk:developing:loading-unloading-vector-data.adoc[Loading and unloading vector data]
-** xref:dsbulk:reference:load.adoc[Loading data examples]
-** xref:dsbulk:reference:unload.adoc[Unloading data examples]
-* xref:dsbulk:reference:dsbulk-cmd.adoc#escaping-and-quoting-command-line-arguments[Escaping and quoting command line arguments]
-* https://github.com/datastax/dsbulk/releases[{dsbulk-loader} release notes]
+** xref:ROOT:troubleshooting-tips.adoc[]
+** xref:ROOT:troubleshooting-scenarios.adoc[]
+** xref:ROOT:contributions.adoc[]
+** xref:ROOT:faqs.adoc[]
+** xref:ROOT:glossary.adoc[]
+** {product-proxy-repo}/releases[{product-proxy} release notes]
+** {product-automation-repo}/releases[{product-automation} release notes]
 
 .{sstable-sideloader}
 * xref:sideloader:sideloader-overview.adoc[]
@@ -58,18 +58,9 @@
 * xref:sideloader:cleanup-sideloader.adoc[]
 * xref:sideloader:troubleshoot-sideloader.adoc[]
 
-.Product-specific migration paths
-* {astra-db}
-** xref:astra-db-serverless:databases:migration-path-serverless.adoc[]
-* {dse}
-** {dse-short} 6.9
-*** xref:6.9@dse:tooling:migration-path-dse.adoc[{dse-short} 6.9 migration tools]
-*** xref:6.9@dse:managing:operations/migrate-data.adoc[Migrate data to {dse-short} 6.9]
-** {dse-short} 6.8
-*** xref:6.8@dse:tooling:migration-path-dse.adoc[{dse-short} 6.8 migration tools]
-*** xref:6.8@dse:managing:operations/migrate-data.adoc[Migrate data to {dse-short} 6.8]
-** {dse-short} 5.1
-*** xref:5.1@dse:managing:operations/migrate-data.adoc[Migrate data to {dse-short} 5.1]
-* {mc}
-** xref:mission-control:migrate:oss-cass-to-mission-control.adoc[Migrate {cass-short} clusters to {mc-short}]
-** xref:mission-control:migrate:dse-to-mission-control.adoc[[Migrate {cass-short} clusters to {dse-short}]
+.{cass-migrator}
+* xref:ROOT:cdm-overview.adoc[]
+* {cass-migrator-repo}/releases[{cass-migrator-short} release notes]
+
+.{dsbulk-migrator}
+* xref:ROOT:dsbulk-migrator-overview.adoc[]

modules/ROOT/pages/astra-migration-paths.adoc

@@ -0,0 +1,106 @@
+= {astra} Migration Toolkit
+:description: Learn which migration tools are compatible with your origin cluster.
+
+The {astra} Migration Toolkit includes all xref:ROOT:components.adoc[{company} migration tools] that are designed to help you migrate your data to {astra-db}.
+
+== Migration tool compatibility
+
+Use the following table to learn which tools are compatible with your current database provider or service:
+
+[cols="2,1,1,1,1"]
+|===
+|Origin |{sstable-sideloader} |{cass-migrator} |{product-proxy} |{dsbulk-migrator}/{dsbulk-loader}
+
+|Aiven for {cass-short}
+|✅
+|✅
+|✅
+|✅
+
+|Amazon Keyspaces
+|❌
+|✅
+|✅
+|✅
+
+|{cass-reg} OSS 3.11 or later
+|✅
+|✅
+|✅
+|✅
+
+|{cass-reg} OSS 3.10 or earlier
+|❌
+|✅
+|✅
+|✅
+
+|Azure Cosmos DB ({cass-short} API)
+|❌
+|✅
+|✅
+|✅
+
+|Azure Managed Instance for {cass}
+|✅
+|✅
+|✅
+|✅
+
+|{dse-short} 5.1 or later
+|✅
+|✅
+|✅
+|✅
+
+|{dse-short} 5.0 or earlier
+|❌
+|✅
+|✅
+|✅
+
+|Instaclustr Managed {cass-short}
+|✅
+|✅
+|✅
+|✅
+
+|K8ssandra (self-managed)
+|✅
+|✅
+|✅
+|✅
+
+|Scylla Cloud
+|❌
+|✅
+|✅
+|✅
+
+|Scylla OSS or Enterprise
+|❌
+|✅
+|✅
+|✅
+
+|Yugabyte Aeon (YCQL)
+|❌
+|✅
+|✅
+|✅
+
+|Yugabyte OSS or Anywhere
+|❌
+|✅
+|✅
+|✅
+
+|===
+
+== Get support for your migration
+
+If you have questions about migrating from a specific source to {astra-db}, contact your {company} account representative, {support-url}[{company} Support], or an https://www.datastax.com/products/datastax-astra/migration-toolkit[{astra} Migration Toolkit expert].
+
+== See also
+
+* xref:astra-db-serverless:databases:migration-path-serverless.adoc[Migrate to {astra-db}]