e1039 core offline - E1039-Collaboration/e1039-wiki GitHub Wiki

Offline Version of e1039 core

The "official" software package for offline analyses is located in /exp/seaquest/app/software/osg/software/e1039. It is propagated everyday into the CVMFS area, /cvmfs/seaquest.opensciencegrid.org/seaquest/software/e1039.

Usage

Host Command
Interactive nodes source /exp/seaquest/app/software/osg/software/e1039/this-e1039.sh
Job nodes source /cvmfs/seaquest.opensciencegrid.org/seaquest/software/e1039/this-e1039.sh

Practically

  • User can auto-source the setup script in ~/.bashrc as follows;
    if [ ${HOSTNAME:0:13} = 'spinquestgpvm' ] ; then
        source /exp/seaquest/app/software/osg/software/e1039/this-e1039.sh
    fi
    
  • All scripts that run on job nodes (i.e. submitted via jobsub_submit) have to source the one in the CVMFS area.

Version Control

Managed by the offline-software expert (Abi). Below is the (yet suggested) procedure for updating the version.

  1. Decide (or be asked) to update the version when a GitHub pull request is merged.
  2. Execute the following command on spinquestgpvm01;
    /exp/seaquest/app/software/osg/software/e1039/script/build-osg-e1039-core.sh pr.62
    
    The 1st argument (pr.62) is a label of the new version, which should be usually the number of pull request.
  3. Wait for one day so that the CVMFS area is updated.
  4. Run a small job to confirm that the new version works fine.
  5. Announce to E1039 ML that the default version will change, and wait for one day (or longer if someone wants).
  6. Change the default version by the following command;
    /exp/seaquest/app/software/osg/software/e1039/core/change-default.sh pr.62
    

Note:

  • The number/size of files on the CVMFS area is limited. So we should/can not put every pull-requested version in it.
  • There is a way (command) to instantly update the CVMFS area. We could use it to control the update timing.