How To Install AMS Software on a Remote Linux Machine

This is a quick guide to getting set up on a remote Linux machine. It is still incomplete, but may give some helpful hints. Here I give the example of creating an executable to run AMS MC. Please email Kate Scholberg with questions, comments, etc.

I have things running on RedHat 6.2, an MIT LNS "white" machine, but it should work with other distributions and versions, too. First, here is a (partial) list of software you will need to have installed.

AFS client software
gcc-2.95.3, available from gcc.gnu.org. Make sure that your path is such that this version of g++ is used.
Root 3.03, available from root.cern.ch. Don't install pre-compiled binaries-- it is best to compile from source using the "linux" configure option. Set ROOTSYS and LD_LIBRARY_PATH to point to your Root directory. Compile using gcc-2.95.3
cernlib
naglib. This is proprietary software and expensive, but you can access it via your CERN AFS account; see below.

You will need to have a CERN AMS account and access to ams.cern.ch. Please ask Alexei Klimentov, Alexei.Klimentov@cern.ch (if you do not know him, make sure to get authorization from someone in the collaboration). You will also need access to the CERN AMS Linux PC's, e.g. pcamsf2. You can find general AMS software and computing information on the AMS Computing page and the the AMS-02 Software page.

Now, to install:

Access is granted to anyone having an account on ams.cern.ch and/or who is a member of cernva, cernxv groups.

First check out the AMS software tree from the CVS repository, by following the instructions here for a remote linux machine, i.e.
```
  setenv CVS_SERVER "env LOGNAME=${USER} cvs"
  setenv CVSROOT :pserver:amscvs@ams.cern.ch:/amsdat2/SW/cvsroot
  cvs login
  (   Username:   amscvs
  Password:   can be found on ams.cern.ch in  ~ams/cvsams/.cvsams )
  cvs checkout AMS
```
This will get you a copy of the code for the AMS readonly tree, which is mirrored every day. If you are not a developer and only want to run the software, then this is the repository to use. If, on the other hand, you wish to be a developer (i.e. you want to commit code to the repository), then please inform Vitaly Choutko, v.choutko@cern.ch. In this case, it is best to use AFS.
```
pagsh
klog -cell cern.ch -principal (userid)
export CVSROOT=/afs/cern.ch/exp/ams/Offline/CVS
cvs checkout AMS
```
Get the databases according to section VII of the readme: either use AFS or install a local standalone version of the databases. Make sure to set the AMSDataDir environment variable to point to the database.
Copy /afs/cern.ch/exp/ams/Offline/lib/linux/libamsut.a to /usr/local/lib on your local machine (or just access via AFS).
Now go to the install subdirectory of the AMS software tree. This contains Makefiles. For example, Mopt makes a Geant 3.21 executable that outputs ntuples; Mopt_Root makes an executable that outputs Root files. I will use Mopt_Root as an example in the following.
Copy the chosen Makefile to a filename of your choosing and edit it to provide local information, e.g. location of CERN libraries if you choose to use local versions (these can also be accessed via AFS).
Next, there are is a kluge required to make things work (I hope this will have a more elegant solution later):
Copy pcamsf2.cern.ch:/usr/include/dirent.h to the include subdirectory in your repository tree.
To make your AMS MC executable, do e.g.
gmake -f Mopt_Root
This should compile everything, but will still need naglib to link if you do not have a local purchased version. To make naglib available via AFS:
- Log on to one of the AMS Linux machines, e.g. pcamsf2, using your AFS CERN account.
- Make a subdirectory of your AFS home directory at CERN called ~/private, if it does not already exist.
- Copy /afs/cern.ch/sw/lhcxx/specific/i386_redhat51/Nag_Fortran/mark18/lib/libnag.a to that subdirectory
- Edit the NAGDIR environment variable in Mopt_Root to point to this naglib.
- Then, to see this file on your local machine, do,
  pagsh
  then
  klog -cell cern.ch -principal (userid)
  and you should be able to see your private AFS files at CERN.
- Then redo gmake -f Mopt_Root to link, and it should now see the naglib library. (You can also compile the whole thing inside pagsh if you choose).
For Geant 4 executables, in the install subdirectory, first
source g4i
gmake -f Moptg4