BES3 Software at Minnesota

This guide will show you how to set up your environment for BESIII at Minnesota. To do this, you'll need:

• A Minnesota physics account
• Some basic experience with bash
• A few minutes
• A little luck

1. Login to a MNHEP or Twins server. If your default shell isn't bash (i.e., you specially arranged an alternative), start it up. All MNHEP scripts are in bash; no other shell is officially supported.

2. Create a symlink to the BES3 environment script: ln -s /data/farmlib/bes3/environment ~/.bes3rc

   You'll want to source this file every time you login; it loads the BES3 environment. You may pass a version number to specify the version of BOSS you'd like to load; otherwise, the current supported version will be loaded. source ~/.bes3rc 6.4.0

   The file sets your work area to ~/work.bes3 by default. If you'd prefer a different directory, export your own WorkArea variable before you source the BES3 environment (it won't be overwritten): export WorkArea=$HOME/my/work/area source ~/.bes3rc

3. You're good to go! IHEP's preferred analysis directory is $WorkArea/Analysis/Physics; create it and from there run cmt create MyAlgorithm MyAlgorithm-00-00-00

   Of course, you'll probably want to be able to actually run your algorithm on some data, so you'll want a copy of TestRelease. cp -r $BesArea/TestRelease $WorkArea/

4. To test out your work area, clear your environment (by logging out and back in, perhaps?), load the BES3 environment script and run this command: pushd $WorkArea/TestRelease/TestRelease-00-00-34/cmt && cmt config && source setup.sh && cmt make clean && cmt make distclean && cmt make Note that you're sourcing setup.sh, not setup.csh.

   This will recompile TestRelease from scratch; if you get any errors, there's a mistake somewhere, either in my instructions or your execution of them. E-mail me either way.

howell at physics dot umn dot edu