Software installation instructions (1.3)

Linux:

• CentOS 6.5
• Ubuntu 12.04
• Fedora 23

Mac:

• Yosemite
• El Capitan

• Version 1.2
  

General Requirements:

• about 4GB of disk space
• csh shell
• cmake >= 2.8 (for clhep and geant4)
• network connection to dwonload packages during installation
• wget, scons, mysql

MAC OS specific requirements

Starting with Yosemite, the software to install packages is homebrew. You can install packages with commands like:

 brew install wget. 

• xcode and developers tools. Both can be installed, each with the line (you have to run it twice):

   xcode-select -install 

Ubuntu (Debian-line) specific requirements

These can be installed with apt-get like this:

 apt-get install libmysqlclient. 

• g++
• libmysqlclient-dev
• llibexpat1-dev
• libglu1-mesa-dev
• libxmu-dev
• pkg-config

Fedora (red-hat line) specific requirements

These can be installed with yum (or dnf for latest Fedora releases) like this:

 yum install gcc-c++ 

 dnf install gcc-c++ 

• gcc-c++
• libx11-devel
• mesa-libGLU-devel
• libXmu-devel
• expat-devel
• zlib-devel
• community-mysql-embedded-mysql

Installation:

1. Choose a place (JLAB_ROOT) to install the software
   A common choice for JLAB_ROOT is /opt/jlab_software.
   
   Create the working directory:

    mkdir -p $JLAB_ROOT/1.3
   		 

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

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

2. Get the installation scripts:

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

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

    > Common Environment Version: <1.3>  (Thu March 31 2016)
    > Running as ungaro on Maurizios-Mac-Pro.local
    > OS Release:    Darwin__macosx10.11-x86_64-clang7.0.2
    > JLAB_ROOT set to:     /opt/jlab_software
    > /opt/jlab_software/1.3/Darwin__macosx10.11-x86_64-clang7.0.2 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 BANKS installation found.
   	 

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


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

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

    cd $JLAB_ROOT/1.3/install
    
    ./go_clhep
    ./go_xercesc
    ./go_qt
    ./go_geant4
    ./go_sconsscript
    ./go_evio
    ./go_mysql
    ./go_ccdb
    ./go_gemc
    ./go_fields
    ./go_root
    ./go_banks
    ./go_jana
   		 

   All the packages listed above "go_gemc" are necessary to run gemc.