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, as described here. 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), orDirectly 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