Upgrade to DataStax Enterprise (DSE) 5.1 using the DataStax Installer

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

Although the Installer facilitates upgrades, DataStax recommends that you carefully review the planning guide and all upgrade instructions to reduce the chance of errors and data loss.

The DataStax Installer upgrades DSE and automatically performs many upgrade tasks:

Drains the currently running node.
Preserves the configuration files and places them in a backup directory.

For DSE 4.5 to 5.1, the default DataStax Installer backup directory name is based on date and time, such as 20170212_221550, and the default location depends on your installation type:
- Installer-Services installations: /usr/share/dse/backups/backup_file_dir
- Installer-No Services installations: install_location/backups/backup_file_dir
Removes previously installed packages.
Updates the cassandra.yaml and dse.yaml configuration files with new entries.

Upgrade Linux installations using the DataStax Installer

Familiarize yourself with the changes and features in the latest DSE 5.1 release notes.
Review the 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.
Review Cassandra version changes in CHANGES.txt.
Upgrade to the latest patch release for your current version. Fixes included in the latest patch release can simplify the upgrade process.

Get the current DSE version, and then compare it against the latest patch release:
```
bin/dse -v
current\_dse\_version
```
Verify the Java runtime version and upgrade to a supported version if needed.
```
java -version
```
For DSE 5.0 and later, the JDK is recommended because it provides useful troubleshooting tools that are not in the JRE, such as jstack, jmap, jps, and jstat.

Download the Installer for your target major and minor version. For example:

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

Change to the directory where you downloaded the Installer, and then make it executable:
```
chmod +x DataStaxEnterprise-version\_number-linux-x64-installer.run
```

Run the Installer with sudo:

sudo ./DataStaxEnterprise-version\_number-linux-x64-installer.run

Follow the instructions in the setup wizard. For more information about the settings, see the DSE 5.1 installation instructions.
If you are installing a version earlier than 5.1.16, and any tables use DSE Tiered Storage, remove all txn_compaction log files from second-level tiers and lower.

Failure to complete this step can result in data loss.

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
```
After completing the install wizard process, start DSE:
```
sudo service dse start
```
For DSE 4.7 and 4.8 only, start the DataStax Agent:
```
sudo service datastax-agent start
```
For DSE 5.1, use OpsCenter to manage agents.
Verify that DSE is running:
```
nodetool status
```

Upgrade to DataStax Enterprise (DSE) 5.1 using the DataStax Installer

Upgrade Linux installations using the DataStax Installer

Was this helpful?

Give Feedback