Software installation instructions (JLAB_VERSION 2.0)

Linux:

• CentOS 6.5
• Ubuntu 12.04
• Fedora 23

Mac:

• El Capitan

• Development Version
  
• Version 1.3
  
• Version 1.2
  

General Requirements:

• about 4GB of disk space
• csh shell
• cmake >= 3.3 (for geant4. check with cmake --version)
• network connection to download the various packages during installation
• wget, scons, mysql, git

MAC OS specific requirements

You can install the dependencies with homebrew:


List of packages Collapse List
• brew install wget
• brew install scons
• brew install cmake
• brew install homebrew/versions/mysql56


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

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-5.6
• 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 tcsh
• sudo apt-get install cmake
• 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
• mysql: dnf install community-mysql-embedded-mysql
• 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 common choice for JLAB_ROOT is /opt/jlab_software:
   
   

                   set JLAB_ROOT /opt/jlab_software
   				

   
   Create the working directory:

                   mkdir -p $JLAB_ROOT/2.0
               

2. Get the installation scripts:

                   cd $JLAB_ROOT
                   wget http://www.jlab.org/12gev_phys/packages/sources/ceInstall/ceInstall_2.0.tar.gz
                   tar -zxpvf ceInstall_2.0.tar.gz
               

3. Set the environment variables. You should put these lines in your login script:

                   setenv JLAB_ROOT /opt/jlab_software
                   source $JLAB_ROOT/2.0/ce/jlab.csh
               

4. Start a new shell. Now you should see a log similar to this

                   > Common Environment Version: <2.0>  (Wed Oct 6 2016)
                   > Running as ungaro on Maurizios-Mac-Pro.local
                   > OS Release:    Darwin__macosx10.11-x86_64-clang8.0.0
                   > JLAB_ROOT set to:     /opt/jlab_software
                   > /opt/jlab_software/2.0/Darwin__macosx10.11-x86_64-clang8.0.0 is not a directory. Creating it.
                       
                   ? Attention: No CLHEP installation found.
                   ? Attention: No XERCES installation found.
                   ? Attention: No mysql installation found.
                   ? Attention: No QTDIR installation found.
                   ? Attention: No GEANT4 installation found.
                   ? Attention: No ROOT installation found.
                   ? Attention: No GEMC installation found.
                   ? Attention: No JANA installation found.
                   ? Attention: No Scons Script installation found.
                   ? Attention: No EVIO installation found.
                   ? Attention: No CCDB installation found.
                   ? Attention: No BANKS installation found.
                   ? Attention: No MLIBRARY installation found.
   				

If you do, great. You're ready to run the installation scripts
Notice: if you already have some existing environment variables that you want to keep, use the option "keepmine":


            source $JLAB_ROOT/2.0/ce/jlab.csh keepmine
        

5. Choose the packages you wish to install by executing the corresponding script:

                   cd $JLAB_ROOT/2.0/install
                   
                   ./go_clhep
                   ./go_xercesc
                   ./go_qt
                   ./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.