DataStax Enterprise 3.1 Documentation

Upgrading from any Datastax Community version

This documentation corresponds to an earlier product version. Make sure this document corresponds to your version.

Latest DSE documentation | Earlier DSE documentation

Uninstall DataStax Community first

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
    

Converting snitches

The snitch is set in the dse.yaml file instead of cassandra.yaml file. 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.