lsstinstall tool, which creates conda environments for installing the LSST Science Pipelines, is now available for beta testing. It will eventually replace the
newinstall tool, but during this beta test period both are still available.
After this user beta testing period and an RFC, uses of
newinstall in the release process, container builds, and documentation are expected to be converted to
$ curl -LO https://ls.st/lsstinstall $ bash lsstinstall
- It uses mambaforge rather than miniconda, giving much faster environment solutions and installations. (5 minutes vs. more than 60 currently on CentOS.)
- It generates a
loadLSST.shscript that can be used in any non-csh-based shell (at least those supported by conda).
loadLSST.bashcan still be used (it is a link). csh/tcsh remain unsupported.
- It can be used for any conda-based LSST Science Pipelines release (anything after w_2020_20), so there is no need to use a release-specific script. The
mainversion should be used in all cases.
- It can install the latest rubin-env version, the version for a given release, or the exact dependency versions that were used to build a given release (e.g. for production purposes).
- Multiple rubin-env versions can be maintained in the same directory using different environment names. The environment name can be passed to
loadLSST.sh. User-customized environments can be used (but the user must ensure compatibility).
- After sourcing
loadLSST.sh, users can do so again to get a different environment and corresponding LSST Science Pipelines packages. (Using a fresh shell may still be useful to ensure cleanliness.)
- LSST Science Pipelines packages are installed in an eups stack within the conda environment to ensure proper dependencies.
Usage: lsstinstall [-n] [-T EUPS_TAG | -X EUPS_TAG | -v RUBINENV_VERSION] [-e ENV_NAME] [-u] [-P CONDA_PATH] [-E EUPS_URL] [-B] [-S] [-h] Installs the Rubin software conda environment. Enables the eups distrib install command for Science Pipelines packages. -n -- No-op. Echo commands instead of running. -T EUPS_TAG -- Select the rubin-env version used to build the given EUPS_TAG. -X EUPS_TAG -- Select the exact environment used to build the given EUPS_TAG. -v RUBINENV_VERSION -- Select a particular rubin-env version (default=latest). -e ENV_NAME -- Specify the environment name to use; if it exists, assume that it is compatible and should be used. -u -- Update rubin-env in an existing environment to the latest build. -P CONDA_PATH -- Use an existing conda installation (default=create a new one). If a conda is activated, it will be used, ignoring this option. -E EUPS_URL -- Select a different EUPS distribution server root URL (default=https://eups.lsst.codes/stack). -B -- DO NOT use binary "tarball" eups packages. -S -- DO NOT use source eups packages. -b -- ignored for backward compatibility. -c -- ignored for backward compatibility. -t -- ignored for backward compatibility. -h -- Display this help message.