• Glossary
  • Support
  • Downloads
  • DataStax Home
Get Live Help
Expand All
Collapse All

DataStax Enterprise Upgrade Guide

    • About upgrading
    • Supported & compatible versions
    • Upgrading DSE
      • Planning your DSE upgrade
      • Upgrades for patch releases
        • 6.8.x patch releases
        • 6.0.x patch releases
        • 5.1.x patch releases
        • 5.0.x patch releases
        • 4.8.x patch releases
      • Upgrading DSE 6.7 to 6.8
      • Upgrading DSE 6.0 to 6.8
      • Upgrading DSE 5.1 to 6.8
      • Upgrading DSE 5.0 to 6.8
      • Upgrading DSE 5.0 to 5.1
      • Upgrading from DataStax Installer
        • Converting to Yum installation on RHEL-based systems
        • Converting to APT installation on Debian-based systems
        • Converting to binary tarball installation
      • Upgrading to earlier versions
        • Upgrading DSE 5.1 to 6.0
        • Upgrading DSE 5.0 to 6.0
        • Upgrading to DSE 5.0
          • Upgrading from DSE 4.7 to 4.8
        • Upgrading to DSE 4.7 or 4.8
        • Upgrading to DSE 4.6
        • Upgrading to DSE 4.0 or 4.5
        • Upgrading to DSE 3.2
          • Upgrading from DSE 3.0 to 3.2
          • Upgrading from DSE 2.2 to 3.2
        • Upgrading 5.1 using the DataStax installer
      • Backing up and restoring DSE
        • Backing up a package installation
        • Backing up a tarball installation
        • Restoring a DSE package installation from backup
        • Restoring a DSE tarball installation from backup
    • Upgrading Apache Cassandra
      • Upgrading Apache Cassandra to DSE
      • Upgrading Apache Cassandra
    • Upgrading OpsCenter
      • Before upgrading OpsCenter
      • DSE OpsCenter upgrade instructions
        • Upgrading package installations
        • Upgrading tarball installations
        • Upgrading when failover is enabled
        • Upgrading DataStax Agents
    • Upgrading DataStax Studio
    • Upgrading the DataStax AMI
  • DataStax Enterprise Upgrade Guide
  • Upgrading DSE
  • Upgrading to earlier versions
  • Upgrading 5.1 using the DataStax installer

Upgrading DataStax Enterprise 5.1 using the DataStax installer

These steps show how to upgrade to versions of DataStax Enterprise (DSE) up to 5.1 using the GUI installer.

DataStax is offering a complimentary half-day Upgrade Assessment. This assessment is a DataStax Services engagement designed to assess the upgrade compatibility of your existing DSE deployment to later DSE versions, including 5.1, 6.0, 6.7, and 6.8. Contact the DataStax Services team to schedule your assessment.

The DataStax installer is removed starting with DSE 6.0.

The DataStax installer upgrades DataStax Enterprise and automatically performs many upgrade tasks:

  • Drains the currently running node.

  • Preserves the configuration files and places them in a backup directory.

  • Removes previously installed packages.

  • Updates the cassandra.yaml and dse.yaml configuration files with new entries.

Prerequisites

To upgrade to the latest version of DataStax Enterprise using the DataStax Installer, ensure the following requirements are met:

  • DataStax Enterprise 5.0 for upgrading to 5.1

Read and understand these instructions before upgrading. Carefully reviewing the planning and upgrade instructions can prevent errors and data loss.

DataStax Enterprise and Apache Cassandra™ Configuration Files

cassandra.yaml

The location of the cassandra.yaml file depends on the type of installation:

Package installations + Installer-Services installations (DSE 4.5 to 5.1)

/etc/cassandra/cassandra.yaml

Tarball installations + Installer-No Services installations (DSE 4.5 to 5.1)

<install_location>/conf/cassandra.yaml

Default DataStax Enterprise installer backup locations (DSE 4.5 to 5.1)

The backup directory name is based on date and time. For example: 20170212_221550

Table 1. Default Location of Configuration Files Dependent On Installation Type

Installer-Services

/usr/share/dse/backups/backup_file_dir

Installer-No Services

install_location/backups/backup_file_dir

dse.yaml

The location of the dse.yaml file depends on the type of installation:

Package installations

/etc/dse/dse.yaml

Tarball installations

<installation_location>/resources/dse/conf/dse.yaml

Upgrading Linux installations using the DataStax Installer

  1. Familiarize yourself with the changes and features in the release:

    • DataStax Enterprise release notes for 5.1.

    • General upgrade advice and Cassandra features in NEWS.txt. If you are upgrading from an earlier version, read NEWS.txt all the way back to your current version.

    • Cassandra changes in CHANGES.txt.

  2. Upgrade to the /en/upgrade/doc/upgrade/datastax_enterprise/upgdDseMinorTOC.html[latest patch release] on your current version. Fixes included in the latest patch release can simplify the upgrade process.

    Get the current DSE version:

    bin/dse -v
    current\_dse\_version
  3. Verify the Java runtime version and upgrade to the recommended version.

    java -version
    • DataStax Enterprise 5.0 and later

    The JDK is recommended for development and production systems, and provides useful troubleshooting tools that are not in the JRE, such as jstack, jmap, jps, and jstat.

  4. Download the installer for your computer from the DataStax downloads page or use the following command:

    curl --user dsa\_email\_address:password -O https://downloads.datastax.com/enterprise/DataStaxEnterprise-5.1.x-linux-x64-installer.run

    For example, alice can run this command to download DSE 5.1.0:

    curl --user alice@email.com:password -O https://downloads.datastax.com/enterprise/DataStaxEnterprise-5.1.0-linux-x64-installer.run
  5. From the directory where you downloaded the install file, make it executable and run it using the sudo command.

    $ chmod +x DataStaxEnterprise-version\_number-linux-x64-installer.run ## Changes permission to executable
    $ sudo ./DataStaxEnterprise-version\_number-linux-x64-installer.run
  6. Follow the instructions in the setup wizard. For a detailed description of the settings in the wizard, see the installation instructions in 5.1

  7. When upgrading DSE to versions earlier than 5.1.16 , if any tables are using DSE Tiered Storage, remove all txn_compaction log files from second-level tiers and lower. For example, given the following dse.yaml configuration, remove txn_compaction log files from /mnt2 and /mnt3 directories:

    tiered_storage_options:
        strategy1:
            tiers:
                - paths:
                    - /mnt1
                - paths:
                    - /mnt2
                - paths:
                    - /mnt3

    The following example removes the files using the find command:

    find /mnt2 -name "*_txn_compaction_*.log" -type f -delete &&
    find /mnt3 -name "*_txn_compaction_*.log" -type f -delete

    Failure to complete this step may result in data loss.

  8. Start DataStax Enterprise:

    sudo service dse start ## Starts the DataStax Enterprise server
  9. (DataStax Enterprise 4.7 and 4.8 only) Start the DataStax Agent:

    sudo service datastax-agent start

    For DataStax Enterprise 5.1, see the OpsCenter 6.1 documentation.

  10. Verify that DataStax Enterprise is running:

    nodetool status
Upgrading from DSE 2.2 to 3.2 Backing up and restoring DSE

General Inquiries: +1 (650) 389-6000 info@datastax.com

© DataStax | Privacy policy | Terms of use

DataStax, Titan, and TitanDB are registered trademarks of DataStax, Inc. and its subsidiaries in the United States and/or other countries.

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries.

Kubernetes is the registered trademark of the Linux Foundation.

landing_page landingpage