Software installation instructions (JLAB_VERSION 2.1)

Linux:

• CentOS 6.5
• Ubuntu 12.04
• Fedora 23

Mac:

• El Capitan

• Development Version
  
• Version 2.0
  
• 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

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


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-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
• 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.1
               

2. Get the installation scripts:

                   cd $JLAB_ROOT
                   wget http://www.jlab.org/12gev_phys/packages/sources/ceInstall/ceInstall_2.1.tar.gz
                   tar -zxpvf ceInstall_2.1.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.1/ce/jlab.csh
               

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

   				> Common Environment Version: <2.1>  (Wed Jul7 5 2017)
   				> Running as ungaro on MauriMP.local
   				> OS Release:    Darwin_macosx10.12-x86_64-clang8.1.0
   				> JLAB_ROOT set to:     /opt/jlab_software
   				> '/opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0' is not a directory. Creating it.
   
   				!! Attention:  BANKS  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/banks/1.2/bin  not found
   				!! Attention:  CCDB  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/ccdb/ccdb-1.06.02/lib  not found
   				!! Attention:  CLHEP  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/clhep/2.3.4.3/lib  not found
   				!! Attention:  EVIO  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/evio/5.1/bin  not found
   				!! Attention:  GEANT4  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/geant4/4.10.02.p03/bin  not found
   				!! Attention:  GEMC  installation check /opt/projects/gemc/source/gemc  not found
   				!! Attention:  JANA  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/jana/0.7.7p1/bin/jana  not found
   				!! Attention:  MLIBRARY  installation check /opt/projects/mlibrary/lib  not found
   				!! Attention:  MYSQL  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/mysql/lib  not found
   				!! Attention:  QT    installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/qt/5.8.0/5.8/clang_64/lib  not found
   				!! Attention:  ROOT  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/root/6.08.04/bin/root-config  not found
   				!! Attention:  SCONS  installation check /opt/jlab_software/2.1/scons_bm/1.5/site_tools  not found
   				!! Attention:  XERCESC  installation check /opt/jlab_software/2.1/Darwin_macosx10.12-x86_64-clang8.1.0/xercesc/3.1.4/lib  not found
   			

If you do, great. 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.1/ce/jlab.csh keepmine
        

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

                   cd $JLAB_ROOT/2.1/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.