DataStax Upgrade Guide

Upgrading from any Datastax Community version

Before upgrading to DataStax Enterprise 4.0 or 3.2 from any DataStax Community version you must follow these steps.

Procedure

  1. Uninstall DataStax Community If you installed the DataStax Community Debian or RPM packages, you must remove DataStax Community after backing up your configuration files and before setting up and installing from the appropriate repository.
    • For Debian packages:
      sudo apt-get remove dsc cassandra
      sudo apt-get autoremove

      This action also shuts down Cassandra on the node if you haven't done so already.

    • For RPM packages:
      rpm -e apache-cassandra1 –noscripts

      The old Cassandra configuration file is renamed to cassandra.yaml.rpmsave:

      warning: /etc/cassandra/default.conf/cassandra.yaml
      saved as /etc/cassandra/default.conf/cassandra.yaml.rpmsave
  2. Converting snitches The snitch is set in the dse.yaml file instead of cassandra.yaml. The dse.yaml is located in the install_location/resources/dse/conf directory. The following table describes how to convert these properties:
    endpoint_snitch URL Upgrade task
    org.apache.cassandra.locator.SimpleSnitch Leave the DseDelegateSnitch as set in the cassandra.yaml file and leave the default delegated_snitch in the new dse.yaml file unchanged.
    org.apache.cassandra.locator.PropertyFileSnitch Copy/paste the cassandra-topology.properties file from the old installation to install_location/ resources/cassandra/conf, overwriting the new properties file. Set the delegated_snitch setting in the new dse.yaml file to:org.apache.cassandra.locator.PropertyFileSnitch.
    Any other snitch URL Change the default delegated_snitch in the new dse.yaml file to your current snitch setting.

    The default delegated_snitch (com.datastax.bdp.snitch.DseSimpleSnitch) is specified in the new dse.yaml file.