Migration operations
Migrating the base port
It is possible to change the base port of an existing Data Science Studio instance, by editing the installation configuration file :
-
Stop DSS
DATADIR/bin/dss stop
-
Edit the
DATADIR/install.ini
installation configuration file[server] port = NEW_BASE_PORT
-
Regenerate DSS configuration
DATADIR/bin/dssadmin regenerate-config
-
Restart DSS
DATADIR/bin/dss start
Migrating the installation directory
It is possible to change the installation directory of an existing Data Science Studio instance, by replaying the installer in “upgrade” mode:
-
Stop DSS
DATADIR/bin/dss stop
-
Move the installed kit to its new location (or unpack the .tar.gz distribution archive to a new location)
mv OLD_DIR/dataiku-dss-VERSION NEW_DIR/ # or cd NEW_DIR tar xf /PATH/TO/dataiku-dss-VERSION.tar.gz
-
Run the installer in upgrade mode
NEW_DIR/dataiku-dss-VERSION/installer.sh -d DATA_DIR -u
-
If you have configured DSS with User Isolation Framework , run the impersonation installation step as
root
fromDATADIR
./bin/dssadmin install-impersonation DSSUSER
-
Restart DSS
DATADIR/bin/dss start
Migrating the data directory
It is possible to change the path of the data directory of an existing Data Science Studio instance, by replaying the installer in “upgrade” mode. Note that the Python virtual environment has to be rebuilt after migration. This is because Python virtual environments embed their installation path in various places.
-
Stop DSS
DATADIR/bin/dss stop
-
Save the list of locally-installed Python packages
DATADIR/bin/pip freeze -l >local-python-packages.txt
-
Move the data directory to its new location
mv DATADIR NEWDATADIR
-
Remove the Python virtualenv, keeping a backup copy
mv NEWDATADIR/pyenv NEWDATADIR/pyenv.backup
-
Run the installer in upgrade mode. This recreates the Python virtualenv
dataiku-dss-VERSION/installer.sh -d NEWDATADIR -u
-
Reinstall locally-installed Python packages (if any)
NEWDATADIR/bin/pip install -r local-python-packages.txt
-
If you have configured DSS with User Isolation Framework :
-
As
root
, edit the file/etc/dataiku-security/INSTALL_ID/security/security-config.ini
to update, in sectiondirs
, the path underdss_data_dir
. For information on finding INSTALL_ID, see Initial Setup . -
Still as
root
, update the paths in sudoers file/etc/sudoers.d/dataiku-dss-<dss_user>-<dss_instance_id>
to point toNEWDATADIR
-
Still as
root
, either:-
Run
NEWDATADIR/bin/dssadmin install-impersonation DSSUSER
to updateNEWDATADIR/security/execwrapper.sh
-
Or, edit
NEWDATADIR/security/execwrapper.sh
and update the path toCONFIGDIR
to point toNEWDATADIR
-
-
-
Restart DSS
NEWDATADIR/bin/dss start
-
If you have configured DSS to start automatically on server boot :
-
Re-run the
install-boot.sh
command (as root), or -
Directly adjust the data directory path in the service configuration file, which you can locate with:
ls -l /etc/default/dataiku* /etc/sysconfig/dataiku*
-
-
When everything is considered stable, remove the backup
rm -rf NEWDATADIR/pyenv.backup
Note
If you could not save the list of locally-installed Python packages before migration (step 2 above), it is possible to reconstitute it by looking at the package installation directory:
ls -l NEWDATADIR/pyenv.backup/lib/python?.?/site-packages
Migrating DSS to start with a new user
To switch the user that runs DSS or to switch DSS to run with a service account, you will perform a migration operation. In this section:
olddssuser
is the original UNIX user which runs the DSS software
newdssuser
is the new UNIX user to run the DSS software
Before you start, make sure you have a backup of your data directory. If you don’t have one, create one now.
-
As the user
olddssuser
, stop DSS:DATADIR/bin/dss stop
-
Update the ownership of your install directory and data directory so that the new UNIX user
newdssuser
has proper access/permissions:sudo chown -Rh NEW_USER:NEW_GROUP INSTALLDIR DATADIR
-
As the new
newdssuser
, re-run installer in upgrade mode:INSTALLDIR/installer.sh -d DATADIR -u
-
If you have UIF configured in your environment, re-run the install-impersonation script as root, to point to the new
newdssuser
:./DATADIR/bin/dssadmin install-impersonation newdssuser
-
As the new
newdssuser
unix user, restart DSS:DATADIR/bin/dss start
-
If you have a boot-up script installed, set start on boot to the new
newdssuser
. Note that INSTALLDIR and DATADIR must be referenced by their full paths:sudo -i INSTALLDIR/scripts/install/install-boot.sh DATADIR newdssuser