Storage Classes

Storage Classes#

All storage locations default to subdirectories of the Server.DataDir setting. The available classes of variable data are listed below:

• Cache - Stores data to increase performance for computationally intensive operations. Certain operations, such as Git package building, also temporarily cache data here. Defaults to <DataDir>/cache.
• Launcher - Stores data for Job Launcher operations. This location currently stores the stdout and stderr data associated with each Git package builder operation. Defaults to <DataDir>/launcher. For highly available installations ensure that this directory is unique to each server. Consider using the Server.LauncherDir configuration option to customize this.
• Metrics - This directory contains aggregated metrics data to improve Usage Stats performance. Defaults to <DataDir>/metrics.
• Packages - Package tarballs and README files are stored here. Defaults to <DataDir>/packages. This includes:
  • Package tarballs and README files for local packages.
  • Package tarballs and README files git packages.
• CRAN - Package tarballs and README files for CRAN are stored here. Defaults to <DataDir>/cran. This includes:
  • Package tarballs for CRAN packages that have been downloaded.
  • README files for CRAN packages.
• PyPI - Package wheel and source files for PyPI packages are stored here. Defaults to <DataDir>/pypi. This includes:
  • Package wheels and source files for PyPI packages that have been downloaded.
• Bioconductor - Package tarballs and README files for Bioconductor are stored here. Defaults to <DataDir>/bioconductor. This includes:
  • Package tarballs for Bioconductor packages that have been downloaded.
  • README files for Bioconductor packages.
• Binaries - Pre-compiled R package binaries for CRAN packages are stored here. Defaults to <DataDir>/binaries.

While it is not recommended, you can customize the storage directory for each storage class. For example:

[FileStorage "cache"]
Location = /mnt/rstudio-pm-cache

[FileStorage "launcher"]
Location = /mnt/rstudio-pm-launcher

[FileStorage "metrics"]
Location = /mnt/rstudio-pm-metrics

[FileStorage "packages"]
Location = /mnt/rstudio-pm-packages

[FileStorage "cran"]
Location = /mnt/rstudio-pm-cran

[FileStorage "bioconductor"]
Location = /mnt/rstudio-pm-bioconductor

[FileStorage "pypi"]
Location = /mnt/rstudio-pm-pypi

[FileStorage "binaries"]
Location = /mnt/rstudio-pm-binaries

If you customize any of the Package Manager storage directories, the rstudio-pm user must have permission to read, write, and create directories in each data directory.