Upgrading a DSS instance

Note

This does not apply to Mac OS X. Instance upgrade is automatic on OS X.

Prerequisites

The upgrade procedure allows you to upgrade between minor versions of Data Science Studio. For example, you can upgrade from 1.1.2 to 1.1.3 or from 1.1.3 to 1.2.0

This procedure does not cover major version upgrades, for example from version 1.2.3 to 2.0.0.

In the rest of this procedure, DATA_DIR denotes the location of the Data Science Studio Data directory, and OLD_INSTALLDIR denotes the location of the install directory of the old version of Data Science Studio.

Pre-upgrade tasks

Warning

Before upgrading, it is very highly recommended to backup the whole content of the data directory.

Stop the old version of Data Science Studio

DATA_DIR/bin/dss stop

Unpack the new software

Unpack the distribution tarball in the location you have chosen for the new installation directory and move to the installation directory.

tar xzf dataiku-dss-NEWVERSION.tar.gz
cd dataiku-dss-NEWVERSION

Perform the upgrade

./installer.sh -d DATA_DIR -u

Like for normal install, Data Science Studio will check for missing system dependencies, and ask you to run a dependencies installation command with superuser privileges if needed.

DSS will ask you to confirm migration of the existing data directory

Start the new version of DSS

To start Data Science Studio, run the following command:

DATA_DIR/bin/dss start