Upgrade Apache Cassandra® to DSE

Improper upgrades can result in downtime, data loss, and other errors.

To minimize risk for an upgrade, review the entire upgrade guide before you begin, including warnings, restrictions, release notes, and all pre-upgrade, upgrade, and post-upgrade steps.

You must prepare all nodes in the cluster before upgrading any nodes. Failure to prepare all nodes can result in mismatched configurations, repair states, and schemas that can disrupt the upgrade process.

Follow these instructions to upgrade from open-source Apache Cassandra to DataStax Enterprise (DSE).

As an alternative to an in-place upgrade on a live cluster, you can use the Zero Downtime Migration (ZDM) tools to orchestrate live traffic while you prepare a new cluster with your desired DSE version, configuration, and data. After testing the new cluster, you can redirect your application traffic and safely decommission your current cluster. If you need to rollback, you can seamlessly discard the new cluster and continue using your existing cluster. This approach supports more upgrade paths without the need for intermediate upgrades. For other options and more information, see Migrate to DataStax Enterprise (DSE).

Supported upgrade paths depend on your current Cassandra version and your target DSE version. The greater the gap between the current version and the target version, the more complex the upgrade. Upgrades from earlier versions can require one or more intermediate upgrades.

Current Cassandra version In-place upgrade path Cross-cluster upgrade path (recommended)

All Cassandra versions after 3.11, including 4.x and 5.x

In-place upgrades are riskier and more complex due to differences between these versions of open-source Cassandra and the underlying version of Cassandra in DSE. If you cannot use the ZDM tools, contact IBM Support.

Use the ZDM tools.

Cassandra 3.0 or 3.11

You cannot directly upgrade to DSE 6.9. Instead, follow this path:

Use the ZDM tools to avoid an intermediate upgrade.

Cassandra 2.1 or 2.2

You cannot directly upgrade to DSE. Instead, follow this path:

  1. Upgrade to Cassandra 3.0 or 3.11.

  2. Follow the DSE upgrade path for Cassandra 3.0 or 3.11.

  1. Upgrade to Cassandra 2.1.6 or later, if needed.

  2. Use the ZDM tools.

Cassandra 2.0 or earlier

You cannot directly upgrade to DSE. Instead, follow this path:

  1. Upgrade to Cassandra 2.1.

  2. Upgrade to Cassandra 3.0 or 3.11.

  3. Follow the DSE upgrade path for Cassandra 3.0 or 3.11.

The ZDM tools don’t support direct upgrades to DSE from Cassandra 2.0. Instead, you have two options:

  • In-place upgrade to Cassandra 2.1.6 or later, and then use the ZDM tools.

  • Perform two separate upgrades with the ZDM tools. First, upgrade from Cassandra 2.0 to 2.1.6 or 2.2, and then upgrade to DSE. You must handle each upgrade independently, including all preparation, testing, and data validation. Complete one entire upgrade and ensure that it is stable before proceeding to the next upgrade.

For assistance with migrations from Cassandra to DSE, contact IBM Support.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | Privacy policy | Terms of use |  Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM