Difference: LArSoftAtNevis (1 vs. 18)

Distribution

Finding scripts

Setting up the Environment

source /cvmfs/oasis.opensciencegrid.org/microboone/products/setup_uboone.sh

DIstribution

Limitations

Mirror delay

We're using an alternate CVMFS server oasis.opensciencegrid.org. It may take a day or so for a release at FNAL to be available at Nevis.

Builds and releases

mrb g larsoft_suite
mrb g uboonecode

This takes a while to compile the first time, and will take up about 1.5GB in your working directory.

ls $UBFCL_DIR

The only difficulty is that the numbering scheme for uboone does not agree with of LArSoft, since the scripts are updated on a different schedule. To see a list of available versions:

DIstribution

Limitations

Mirror delay

Production scripts

An easy way to access the production MicroBooNE is to set up the uboone product; e.g.:

setup uboone v2_4 -qe4:debug

The uboone setup includes both ubooncode and larsoft. The only difficulty is that the numbering scheme for uboone does not agree with of LArSoft, since the scripts are updated more frequently. To see a list of available versions:

ups list -aK+ uboone

mrb g larsoft_suite
mrb g uboonecode

This takes a while to compile the first time, and will take up about 1.5GB in your working directory.

Limitations of the Nevis LArSoft installation

Nightly builds

Nightly builds are not yet available at Nevis (nor anywhere else outside of uboonevm.fnal.gov).

Bash shell

The mrb+git scripts will only run in the bash shell. In other shells, you'll see error messages about missing libraries or being unable to set up products.

You can temporarily go into the bash shell simply by typing bash. If you want to permanently change your login shell to bash, you can do it via the ypchsh command.

Other shells (tcsh and zsh) will be supported (someday), but the LArSoft maintenance team is not yet ready.

Browsing code on the web

https://cdcvs.fnal.gov/redmine/projects/larreco/repository

Browsing code in UNIX

My preferred way is to look at the code as it's stored on the local computer cluster. After you've set up LArSoft, you can find the code for a given package group in the directory:

$<PACKAGE-NAME>_DIR/source

If you wanted to look at the packages in group larsim, you can do:

ls $LARSIM_DIR/source

Where can one run LArSoft

Since all the machines on the Nevis Linux Cluster are linked together via automount, the software should run on any machine on the cluster, whether or not that particular machine is owned by the Neutrino group. You do not have to login to westside.

Locations

Releases

MicroBooNE guide

Notes

Regular development work

The MicroBooNE guide contains several procedures, but most of them are not commands that you'd type in every day. If your typical work flow is to login and start editing code in something you've already checked out, you may be interested in this script that WilliamSeligman wrote:

/a/share/westside/seligman/microboone/develop_uboone.sh

Let's assume that you've previously set up (via mrb newDev) and checked-out (via mrb gitCheckout) some code that you're working on into your directory ~/mydev, and that code is part of LArSoft release v1_00_02. Then a typical use of this script would be:

source /a/share/westside/seligman/microboone/develop_uboone.sh ~/mydev v1_00_02 e4 debug

This becomes handy if you set up an alias in ~/.bashrc, the script that gets automatically executed when you login to bash:

alias MBD="source /a/share/westside/seligman/microboone/develop_uboone.sh ~/mydev v1_00_02 e4 debug"

Then you just have to type MBD after you login, and you're ready to work.

Look at ~seligman/.bashrc for more ideas.

Finding packages

One potentially-confusing aspect of the new arrangement is that LArSoft has been sub-divided into package groups. In order to check out a package, you have to know which group it's in. For example, you can't check out LArG4; you have to check out "larsim" which is a group of packages, one of which is LArG4.

For a guide as to which package is in which group, see LArSoft dependencies.

Where can one run LArSoft

Since all the machines on the Nevis Linux Cluster are linked together via automount, the software should run on any machine on the cluster, whether or not that particular machine is owned by the Neutrino group. You do not have to login to westside.

Limitations of Nevis LArSoft installation

• Nightly builds are not yet available at Nevis (nor anywhere else outside of uboonevm.fnal.gov).
• The mrb+git scripts will only run in the bash shell. Other shells (tcsh and zsh) will be supported (someday), but the LArSoft maintenance team is not yet ready.

Setting up ROOT and Geant4

LArSoft at Nevis

• The Nevis copy of the LArSoft installation is currently in /a/data/westside/seligman/larsoft.
• The Nevis copy of the uboonecode installation is currently in /a/data/westside/seligman/products.

This documents how to use the LArSoft and MicroBooNE software as managed by mrb+git. If you are looking for older LArSoft versions managed by SRT, see the LArSoft at Nevis SRT page.

As of 07-Feb-2014, the following Fermilab LArSoft releases are maintained at Nevis:

v1_00_02 - Minor compilation fixes; use updated cetbuildtools.  
v1_00_01 - Freeze after switch to mrb+git   

Limitations of Nevis LArSoft installation

• Nightly builds are not yet available at Nevis (nor anywhere else outside of FNAL systems).
• The mrb+git scripts will only run in the bash shell. Other shells (tcsh and zsh) will be supported (someday), but FNAL CD is not yet ready.

Where can one run LArSoft

Since all the machines on the Nevis Linux Cluster are linked together via automount, the software should run on any machine on the cluster, whether or not that particular machine is owned by the Neutrino group. You do not have to login to westside.

Setting up the Environment

The simplest way to initialize the variables to run LArSoft at Nevis is to execute the following command:

source /a/share/westside/seligman/microboone/setup_uboone.sh

You only have to run this once per login session.

After you've run this command, you can follow the instruction in the !MicroBooNE guide.

Nevis notes

When you set up LArSoft, the Nevis-specific setup command is disabled. The LArSoft software distribution contains its own copies of ROOT and Geant4, so there's no need to set-up the Nevis versions. In fact, to make sure the Nevis versions don't conflict with the LArSoft versions, make sure there are no setup commands in any of your shell initialization files like ~/.myprofile, especially if you're switching to LArSoft from some other project or from working on the ROOT tutorial.

The LArSoft environment also affects some standard Linux features, such as the default rules for make and the yum command. If you are doing any work that does not involve LArSoft directly, you're advised not to set up the LArSoft environment as described above.