Binary Distribution Cheat Sheet¶

1. Talk with your experiment's Offline coordinator to learn the qualified version of art that you need.
   • An example might be: art v2_03_00 -q e10:prof or art v2_03_00 -q e10:nu:prof
   • The qualifier mnemonic names are described in the About Qualifiers page.
2. Learn the architecture of the machine on which you plan to run art.
   • The mnemonic names for these architectures include slf6, slf7, d13, d14, and u14.
   • See the short names list at Supported platforms
3. Decide on the absolute path to the directory that will hold the downloaded ups products
   • Make sure that there is at least xx GB of free space to hold the installed products
   • The amount of free space required depends on the distribution. For instance, the larsoft distribution is significantly larger than the mu distribution. Your experiment may have instructions that provide more detail.
4. cd to a scratch directory to hold some temporary files that are created by the process
   • Make sure that there is at least xx GB of free space to hold these files
5. Go to: https://scisoft.fnal.gov
   • Talk with your experiment's Offline coordinator to learn the distribution and version that you need.
   • The distribution version may not be the same as the art version.
   • Distributions include larsoft, nu, mu, art, uboone, etc.
   • If you just want to test drive art, or if you want to run the art workbook, choose art.
6. From the SciSoft home page, click on the appropriate distribution.
7. On the next page, click on the link for the distribution version number. Often this is just the latest available version.
8. On the next page you will see a directory listing showing an html file and some other files. Click on the link to view the html file.
   • Note that both art and larsoft release notes provide a link directly to the download page for the appropriate distribution.
9. Read the instructions in the section "Download scripts for binary distributions"
   • The instructions tell you to download and run a script named pullProducts
   • Explicit download instructions are listed for each available platform.
   • You will need to supply the absolute path to the directory that will hold the downloaded ups products and specify either debug or prof.
10. Follow the instructions to run pullProducts
    • In most cases, you will want the prof distribution.
    • If you also want the debug distribution, run pullProducts again and specify debug instead of prof as the last argument.
11. If you want to install additional versions of your distribution, simply rerun the pullProducts command giving the appropriately revised arguments.
    • Note that if a particular fully qualified product was downloaded by the first run of pullProducts and is requested by the second run, pullProducts is smart enough to know that it does not need to redo the work on the second run.
    • Be sure that there is enough disk space to hold both the scratch files and the installed files
    • Repeat until you have all of the fully qualified versions that you need