Completing the upgrade

Final steps to upgrading Cassandra.

Regardless of your operating system, you perform these steps to complete the upgrade process.

Procedure

  1. Account for new parameters in cassandra.yaml.
  2. Make sure any client drivers, such as Hector or Pycassa clients, are compatible with the new version.
  3. Run nodetool drain before shutting down the existing Cassandra service. This prevents overcounts of counter data, and will also speed up restart post-upgrade.
  4. Stop the old Cassandra process, then start the new binary process.
  5. Monitor the log files for any issues.
  6. If you are upgrading to Cassandra DataStax Community from 1.1.x or earlier or if you use counter tables, run nodetool upgradesstables before doing any move, repair, or bootstrap operation.
    Because these operations copy SSTables within the cluster and the on-disk format sometimes changes between major versions, upgrade SSTables now to prevent possible SSTable incompatibilities.
  7. After upgrading all nodes in the cluster, consider upgrading existing nodes to vnodes.