DataStax Enterprise 3.0 Documentation

Upgrading DataStax Community--tarball

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 nodes from DataStax Community 1.0.x/1.1 to DataStax Enterprise 3.0.x.

Upgrading a node and migrating the data

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 and migrate the data

  1. Create a directory for the new installation, download the tarball, and move it to that directory.

  2. Unpack the DataStax Enterprise 3.0.x tarball in the new install location.

    tar –xzvf <dse-3.0.x tarball name>
    
  3. If you customized the location of the data in the old installation, create a symbolic link to the old data directory:

    cd <new install location>
    ln -s <old data directory> <new install location>/<new data directory>
    

To configure the upgraded node

  1. In the new installation, open the cassandra.yaml for writing. The file is located in:

    <install location>/resources/cassandra/conf
    
  2. In the old installation of Cassandra, open the cassandra.yaml. The file is located in:

    <install location>/conf
    
  3. Diff the new and old cassandra.yaml files.

  4. Merge the diffs by hand from the old file into the new one, except do not merge snitch settings.

    If you are migrating data and set up the symbolic link described in the previous procedure, ensure that you merge the data_file_directories, commitlog_directory, and saved_caches_directory properties correctly.

  5. Configure the snitch setting.

  6. Configure and start the node.

  7. If you meet conditions for, upgrading SSTables, upgrade SSTables now.