The data directory¶
The data directory is the unique location on the DSS server where DSS stores all its configuration and data files.
Notably, you will find here:
Startup scripts to start and stop DSS
Settings and definitions of your datasets, recipes, projects, …
The actual data of your machine learning models
Some of the data for your datasets (those stored in local connections)
Logs
Temporary files
Caches
Finding the data directory¶
The data directory is the directory which you set during the installation of DSS on your server (the -d option).
If you did not install DSS yourself, you can find the path to the data directory by going to Administration > Maintenance > System info (you need to be a DSS administrator for this).
If you use the macOS application, the data directory is automatically set to ~/Library/DataScienceStudio/dss_home
.
Main folders of the data directory¶
The data directory is made of the following folders
Note
Depending on the node type, some of these folders may not exist
R.lib¶
Include in backups: Yes
This folder contains the R libraries installed by calling install.packages()
from a R notebook or recipe, as well as the R libraries that DSS installs when running install-R-integration
.
Note that we recommend using code environments rather than calling install.packages()
manually. For more information, see Code environments.
analysis-data¶
Include in backups: Yes
This folder contains the data for the models trained in the Lab part of DSS.
The data is organized by project, then by visual analysis, then by ML Task. The data for a ML Task is removed when the ML Task (or its containing visual analysis) is removed in DSS.
Depending on the ML engine used, this folder can contain the train and test splits data, which can become big (in splits
folders). It is possible to remove these CSV files, but you will lose some of the ability to compare exactly models since they won’t be based on the same splits.
bin¶
Include in backups: Yes
This folder contains various programs and scripts to manage DSS.
dss: main start/stop script
dssadmin: for offline administration tasks
dsscli: for various administration tasks
env-default.sh, env-hadoop.sh, env-spark.sh, dku, fek, jek, python: internal usage, not for use by end users
env-site.sh for advanced environment customization
pip: for management of the builtin Python environment. For more information, see Code environments.
caches¶
Include in backups: Not needed
This folder contains various precomputed information. It is safe to remove elements in this folder, but some operations in DSS will to recompute them (displaying explore samples and charts)
code-envs¶
Include in backups: Yes
Note
This folder is called acode-envs on the automation node
This folder contains the definitions of all code environments, as well as the actual packages
config¶
Include in backups: Yes
This is the most important folder, where all user configuration and data is stored:
All projects, datasets, recipes, notebooks, webapps, ….
Users and security settings
Connections
API keys
…
This folder contains several Git repositories
databases¶
Include in backups: Yes
This folder contains several internal databases used for operation of DSS:
Usage statistics
Jobs and scenarios histories
Metrics and checks histories
Users watches and stars
Users notifications
Some of the information in these databases can be accessed from DSS itself using the “Internal stats” and “Metrics” virtual datasets
data-catalog¶
Include in backups: Not strictly required
This folder contains the indices and staging data for the DSS data catalog.
exports¶
Include in backups: Not strictly required
This folder contains download files for exports made by users.
It is safe to remove old folders in this folder - exports will not be available anymore for download by users
jobs¶
Include in backups: As desired, not strictly required
This folder contains the job logs and support files for all flow build jobs in DSS, both running and previous.
It is safe to remove folders of jobs that are not currently running. Logs of these jobs will not be available anymore, but the existence of the job will still be registered in the DSS UI.
jupyter-run¶
Include in backups: Yes
This folder contains internal runtime support file for the Juypter notebook.
The “current working directory” of all notebooks is initialized within this folder. If a user’s notebook code writes files to the current working directory, these files will appear in jupyter-run
.
lib¶
Include in backups: Yes
This folder contains administrator-installed global custom libraries (Python and R), as well as JDBC drivers.
local¶
Include in backups: Yes
This folder contains administrator-installed files for serving in web applications
managed_datasets¶
Include in backups: Yes
This is the location of the “filesystem_managed” connection which is installed by default in DSS. It contains datasets data written in this connection.
managed_folders¶
Include in backups: Yes
This is the location of the “filesystem_folders” connection which is installed by default in DSS. It contains folders data written in this connection.
notebook_results¶
Include in backups: Yes
This folder contains the query results for SQL / Hive / Impala notebooks
plugins¶
Include in backups: Yes
This folder contains the plugins (both installed in DSS, and developed directly in DSS)
privtmp¶
Include in backups: Yes
This folder contains security-sensitive temporary files that should not be modified.
run¶
Include in backups: Not required
This folder contains all core log files of DSS. See Diagnosing and debugging issues for more information.
saved_models¶
Include in backups: Yes
This folder contains the data for the models trained in the Flow.
The data is organized by project, then by model id.
scenarios¶
Include in backups: As desired, not strictly required
It is safe to remove folders of scenarios that are not currently running. Logs of these scenarios will not be available anymore, but the existence of the scenario will still be registered in the DSS UI.
timelines¶
Include in backups: Yes
This folder contains databases storing the “timelines” information associated to each kind of DSS object.
uploads¶
Include in backups: Yes
This folder contains the files that have been uploaded to DSS to use as datasets.
DSS is using too much space on disk¶
Please see Managing DSS disk usage
Managing temporary files¶
Please see Managing DSS disk usage