Project

General

Profile

UPS Tips and Info

UPS is environment management software for handling software products with many versions and different 'flavors' of components. You use it to make sure you are using the correct version of the product you need and any dependent products that one may rely on.

In the table below the following example values are used:
  • uboonecode - the product being setup
  • v06_26_01_17 - the version of the uboonecode product for this example. This may not be the latest or best version. (See the Releases page.)
  • e10:prof - the qualifiers for the version of uboonecode. Qualifiers further define something about the version of uboonecode, like how it was built (with profiling or debug) or the version of the gcc compiler used (e10,e14, etc.) for example. (Available qualifiers may vary with version, and can be discovered using the "ups list" command described below.)

Basic UPS Command Information

These commands are done after logging in to the MicroBooNE interactive nodes (e.g. uboonegpvm01.fnal.gov, uboonegpvm02.fnal.gov, ..., uboonegpvm07.fnal.gov).

Command Description Use
source /cvmfs/uboone.opensciencegrid.org/products/setup_uboone.sh Configure your environment, get access to software versions stored in UPS product areas on CVMFS Use once at login
setup uboonecode v06_26_01_17 -q e10:prof Set up a particular version of uboonecode and all dependencies Use once after login, after running setup_uboone.sh
ups list -aK+ uboonecode Find out which versions and flavors of uboonecode exist on this node Use whenever you need to find out what's available
ups active Find out what has been setup Use when you want to
ups depend uboonecode v06_26_01_17 -q +e10:+prof Find out what depends on what for this version of uboonecode Use when you want to

After doing the setup of uboonecode you can see where the software is by looking at the UBOONECODE_DIR (<PRODUCT>_DIR>) variable.

$ echo $UBOONECODE_DIR
/cvmfs/uboone.opensciencegrid.org/products/uboonecode/v06_26_01_17

Further Documentation

When you need to learn more about UPS, visit the following links.

Info on Qualifiers: https://cdcvs.fnal.gov/redmine/projects/cet-is-public/wiki/AboutQualifiers
UPS Full Documentation: http://www.fnal.gov/docs/products/ups/ReferenceManual/