Updating

Updating DSE

Upgrading your cluster from DSE 5.1.10 to 6.7.6

Due to the complexity of upgrading to DSE 6.7, we strongly advise that you attempt the upgrade on a test cluster before upgrading in your production environment.

Also we advise that you upgrade 5.1.10 directly to 6.7.6, skipping 6.7.2, as it has a problem in upgrading when TLS is enabled.

IMPORTANT:
1. This action cannot be undone and you should plan for increased load activity on your cluster. This task should be scheduled for off-peak hours. Should any problems arise, pause the plan and investigate.
2. You must set properties dse_search and dse_analytics to true before upgrading. Afterward, you can reset the configs to the desired value.
3. Due to a bug in DC/OS 2.0.0, upgrading DSE to 6.7.6 will not work. Instead, first upgrade DC/OS to 2.0.1 and then upgrade DSE to 6.7.6.

Prerequisites

In order to upgrade your cluster from DSE 5.1.10 to DSE 6.7.6 you must:

  • Review official DSE upgrade docs
  • If authentication is configured by client in the cluster, then before running the upgrade command, you must create file dse-data/cqlshrc on node-0 with authentication options as below :
    [authentication]
username = user
password = password

Procedure

  1. Run the following command to upgrade your DSE package:

    dcos datastax-dse update start --package-version=3.1.0-6.7.6

    This will run a script to drop COMPACT_STORAGE from all keyspaces and then upgrade each DSE node to version 6.7.6

  2. After DSE upgrade, you can upgrade OpsCenter with the following command:

    dcos datastax-ops update start --package-version=3.1.0-6.7.6

  3. After the OpsCenter upgrade finishes, run the following command to convert sstables to the proper version:

    dcos datastax-dse plan start nodetool-ser \
  [-p NODETOOL_CONNECTION_OPTS='-p 7199']  \  ## optional
  -p NODETOOL_SUBCOMMAND='upgradesstables'  \
  -p NODETOOL_CMD_ARGS='-a'