Lsstinstall available for beta test

The 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.

If you have any questions about or experience any problems with lsstinstall, please post in the Support category, file a Jira ticket, or ask in the #dm-build-problems Slack channel.

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 lsstinstall.

To use lsstinstall:

$ curl -LO https://ls.st/lsstinstall
$ bash lsstinstall

Differences from newinstall:

  • 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.sh script that can be used in any non-csh-based shell (at least those supported by conda). loadLSST.bash can 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 main version 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.
2 Likes