DataStax Enterprise 3.0 Documentation

Upgrading DataStax Community--Debian/Ubuntu

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

Latest DSE documentation | Earlier DSE documentation

This procedure shows how to upgrade a cluster of Ubuntu 11.10 nodes from DataStax Community 1.0.x/1.1 to DataStax Enterprise 3.0.x. The installer migrates the data from the old to the new version of Cassandra automatically.

Upgrading a node

Perform these upgrade steps on each node in the cluster. If the cluster is a mixed workload cluster, upgrade in the order described in Order of upgrading nodes. Complete all steps on one node before starting to upgrade the next node.

To upgrade a node

  1. Remove the old packages and dependencies on them.

    sudo apt-get remove dsc cassandra
    sudo apt-get autoremove
    

    This action shuts down Cassandra on the node.

  2. Add the DataStax repository to the /etc/apt/sources.list.

    deb http://<username>:<password>@debian.datastax.com/enterprise stable main
    

    Get the <username> and <password> from your DataStax registration confirmation email. If you don’t have the email, register on the DataStax web site.

  3. Upgrade the node.

    sudo apt-get update
    sudo apt-get install dse-full
    
  4. If the prompt appears informing you of the disk space to be used, type Y to continue.

  5. Configure the upgraded node as described in the next section.

To configure the upgraded node

  1. Open the old cassandra.yaml located in /etc/cassandra.
  2. Open the new cassandra.yaml located in /etc/dse/cassandra.
  3. Diff the new and old cassandra.yaml files, merging the diffs by hand from the old file into the new one, except do not merge snitch settings.
  4. Configure the snitch setting.
  5. Configure and start the node.
  6. If you meet conditions for upgrading SSTables, upgrade SSTables now.