Software installation instructions (JLAB_VERSION 2.2)

Linux:

• CentOS 7

Mac:

• Sierra
• High Sierra

• Development Version
  
• Version 2.2
  
• Version 2.1
  
• Version 2.0
  

General Requirements:

• csh shell
• cmake >= 3.3 (for geant4. check with cmake --version)
• network connection to download the various packages during installation
• wget
• scons version 2 to 2.5.1
• mysql
• git
• recommended: qt

⌘ MAC OS specific requirements

Make sure you have the latest xcode tools with:

 xcode-select --install
		

You can install the dependencies with homebrew:


List of packages Collapse List
• brew install wget
• brew install scons*
• brew install cmake
• brew install mysql
• brew install openssl
It is much better to use the system version of qt):
• brew install qt


* if you are on High Sierra, brew will install scons3. Not good. Go to http://scons.org/pages/download.html instead and use

 python setup.py install
                    

inside the untarred 2.5.1 dir.

You can upgrade a package by using "upgrade" instead of "install"

Notice: mysql56 or mysql@56 are no longer supported. If you have it installed, please issue the command: brew remove homebrew/versions/mysql56

🐧 Ubuntu (Debian-line) specific requirements

You can install the dependencies with apt-get:


List of packages Collapse List
• sudo apt-get install g++
• sudo apt-get install mysql-client
• sudo apt-get install libmysqlclient-dev
• sudo apt-get install libx11-dev
• sudo apt-get install libxext-dev
• sudo apt-get install libglu1-mesa-dev
• sudo apt-get install libxt-dev
• sudo apt-get install libxmu-dev
• sudo apt-get install libxrender-dev
• sudo apt-get install libexpat1-dev
• sudo apt-get install libxft-dev
• sudo apt-get install tcsh
• sudo apt-get install cmake
• sudo apt-get install git
• sudo apt-get install libafterimage-dev
• sudo apt-get install scons

🐧 Fedora (red-hat line) specific requirements

You can install the dependencies with dnf (or yum):


List of packages Collapse List
• dnf install gcc-c++
• dnf install libx11-devel
• dnf install mesa-libGLU-devel
• dnf install libXmu-devel
• dnf install expat-devel
• dnf install zlib-devel
• dnf install community-mysql-embedded-mysql
  (the mysql package name may vary depends on the OS, you can dnf yum search mysql to find out the available version)

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
   			

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
		

5. 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.

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