Software installation instructions (JLAB_VERSION 2.2)

These instructions are verified on:
These are instructions to install JLAB_VERSION 2.2. You can find supported JLAB_VERSION releases instructions below:

General Requirements:



Installation:

  1. Choose a place (JLAB_ROOT) to install the software

    A good choice for JLAB_ROOT is /opt/jlab_software:
    
     set JLAB_ROOT=/opt/jlab_software
    			
    Create the working directory:
    
     mkdir -p $JLAB_ROOT/2.2
    			
  2. Get the installation scripts:
    
     cd $JLAB_ROOT
     wget http://www.jlab.org/12gev_phys/packages/sources/ceInstall/ceInstall_2.2.tar.gz
     tar -zxpf ceInstall_2.2.tar.gz --strip-components 1 -C 2.2
                
  3. Set the environment variables. You should put these lines in your login script:
    
     setenv JLAB_ROOT /opt/jlab_software
     source $JLAB_ROOT/2.2/ce/jlab.csh
                
  4. Start a new shell. Now you should see a log similar to this
     > Common Environment Version: <2.2>  (Wed March 18 2018)
     > Running as mauri on 1.800.gemc.cool.org
     > OS Release:    Darwin_macosx10.13-x86_64-clang9.0.0
     > JLAB_ROOT set to:     /opt/jlab_software
     > '/opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0' is not a directory. Creating it.
    
     !! Attention:  BANKS  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/banks/1.4/bin  not found
     !! Attention:  CCDB  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/ccdb/ccdb-1.06.02/lib  not found
     !! Attention:  CLHEP  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/clhep/2.3.4.5/lib  not found
     !! Attention:  EVIO  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/evio/5.1/bin  not found
     !! Attention:  GEANT4  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/geant4/4.10.03.p02/bin  not found
     !! Attention:  GEMC  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/gemc/2.7/gemc  not found
     !! Attention:  JANA  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/jana/0.7.7p1/bin/jana  not found
     !! Attention:  MLIBRARY  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/mlibrary/1.2/lib  not found
     !! Attention:  MYSQL  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/mysql/lib  not found
     !! Attention:  QT    installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/qt/5.9.1/5.9.1/clang_64/lib  not found
     !! Attention:  ROOT  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/root/6.12.06/bin/root-config  not found
     !! Attention:  SCONS  installation check /opt/jlab_software/2.2/scons_bm/1.6/site_tools  not found
     !! Attention:  XERCESC  installation check /opt/jlab_software/2.2/Darwin_macosx10.13-x86_64-clang9.0.0/xercesc/3.2.0/lib  not found
    			
  5. If you do, great! The enviroment seems correct and you're ready to run the installation scripts. Every script that you run below will replace the warning log with a successful one.
    Notice: if you already have some existing environment variables that you want to keep, use the option "keepmine":
    
     source $JLAB_ROOT/2.2/ce/jlab.csh keepmine
    		
  6. Choose the packages you wish to install by executing the corresponding script:
    
     cd $JLAB_ROOT/2.2/install
    
     ./go_clhep
     ./go_xercesc
    			
    If you have a system installation of qt (see instructions on requirements on how to install it):
    
     ./go_qt system
    			
    Otherwise the following command will downlowad the qt installer for you. Follow instructions for the installation:
    
     ./go_qt
    			
    Continue with the rest of the package installation:
    
     ./go_geant4
     ./go_sconsscript
     ./go_evio
     ./go_mysql
     ./go_ccdb
     ./go_mlibrary
     ./go_gemc
     ./go_fields
     ./go_root
     ./go_banks
     ./go_jana
                
    All the packages listed above "go_gemc" are necessary to run gemc.
  7. Typical installation times:

    Package Approx Installation Time
    clhep 1 minute
    xercesc 1 minute
    qt (if system installed) 1 second
    qt (if installatin from scratch) 20 minutes
    geant4† 10 minutes
    sconsscript 1 second
    evio 10 seconds
    mysql 1 second
    ccdb 1 minute
    mlibrary‡ 2-3 minutes
    gemc 2-3 minutes
    root 25 minutes
    banks 5 seconds
    jana 1 minute

    Total (system qt) 40 minutes
    Total (qt from scratch) 1 hour

† (needs fast connection to download the cross section data)
‡ you will see a lot of warnings you can ignore related to assimp.


Please email any comments/corrections/bug report/feature requests to Maurizio Ungaro.