Upgrading a DSS instance


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


The upgrade procedure allows you to upgrade between revisions (1.2.X) and minor versions (1.Y) 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. For major version upgrades, see the release note of the target major version.

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.

Notes and limitations

The following migration notes and limitations apply to all minor versions of DSS (for example from 2.1 to 2.2):

  • Due to frequent upgrades of the underlying libraries, the saved models recorded in the Flow may not be usable for scoring anymore and may need to be retrained (relaunching the train recipe)
  • The packages deployed in an API node generally need to be regenerated on DSS and redeployed on the API node.

Pre-upgrade tasks


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