DataStax Enterprise 2.2 Documentation

Upgrading from DataStax Enterprise 1.x.x - 2.1.x to 2.2.x

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

Latest DSE documentation | Earlier DSE documentation

Under either of these conditions, you need to restart the nodes as real-time Cassandra nodes before upgrading as described in the following procedures:

  • If you are upgrading from DataStax Enterprise 2.0.x to 2.2.x.
  • If the cluster contains any Solr or Hadoop nodes.

If you are not upgrading under these conditions, restarting the nodes as real-time Cassandra nodes is an extra step that you can skip. Restarting the nodes as real-time Cassandra nodes prevents unwanted schema changes from occurring when you start the upgraded node.

To upgrade a tarball release

  1. Stop the first node to be upgraded and restart it as a real-time Cassandra node:

    dse cassandra
    
  2. Follow the instructions in Upgrading a Tarball Installation of DataStax Community 1.0.x/1.1 to DataStax Enterprise 2.2.x.

  3. Start each node as a real-time Cassandra node during the rolling upgrade.

  4. Validate the upgrade of each node.

  5. After all nodes are upgraded and the schemas agree, use another rolling restart to put the nodes back to their original roles as Hadoop or Solr nodes:

    For Hadoop:

    dse cassandra -t
    

    or

    For Solr:

    dse cassandra -s
    

To upgrade a packaged release

  1. Stop the dse service, and then disable Hadoop or Solr by setting options in /etc/default/dse:

    • To disable Hadoop: HADOOP_ENABLED=0
    • To disable Solr: SOLR_ENABLED=0
  2. Restart the dse service.

  3. Run the Yum (CentOS/RHEL/Oracle Linux) or Aptitude (Debian/Ubuntu) update commands.

  4. Run the install commands shown in Installing the DataStax Enterprise Package on Debian and Ubuntu or Installing the DataStax Enterprise Package on RHEL-based Distributions.

  5. Start the first node.

  6. Configure the node: Open the old cassandra.yaml. Open the new cassandra.yaml:

    Debian/Ubuntu: /etc/dse/cassandra

    RHEL-based: /etc/dse/cassandra/cassandra.yaml

    Diff the new and old cassandra.yaml files. Merge the diffs by hand from the old file to the new one except do not merge the snitch setting.

  7. Configure the snitch setting and complete the upgrade as described in Completing the Configuration and Starting Up the Upgraded Node.

  8. Start up each node as a real-time Cassandra node during the rolling upgrade (leave HADOOP or SOLR disabled).

  9. Validate the upgrade.

After all nodes are upgraded and the schemas agree, you can use a rolling restart to set the nodes back to their original roles as Hadoop or Solr nodes.

To restart nodes

  1. Stop the dse service, and then enable Hadoop or Solr by setting options in /etc/default/dse:
    • To enable Hadoop: HADOOP_ENABLED=1
    • To enable Solr: SOLR_ENABLED=1
  2. Start DSE as a Solr node.
  3. Repeat the previous steps for each node.