Software installation instructions

Linux:

• CentOS 6.5
• Ubuntu 12.04
• Fedora 20

Mac:

• Mountain Lion
• Yosemite

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
• ibmysqlclient-dev
• libx11-dev
• libxext
• libxext-dev
• libglu1-mesa-dev
• libxt-dev
• libxmu-dev
• llibexpat1-dev
• libglib-dev

Fedora (red-hat line) specific requirements

These can be installed with yum like this:

 yum install community-mysql. 

• gcc-c++
• community-mysql
• community-mysql-devel
• libx11-devel
• libGLU-devel
• libXt-devel
• libXmu-devel
• expat1-devel

Installation:

1. Choose a place to install the software, and a JLAB_VERSION.
   A common location choice is /opt/jlab_software. JLAB_VERSION can be 1.1, 1.2, or "devel".
   
   Set the environment variable accordingly:

   setenv JLAB_ROOT /opt/jlab_software
   setenv JLAB_VERSION 1.2
   		 

2. Get the installation scripts:

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

3. From now on you can use these lines to set up the environment. Remember to cleanup your login scripts to avoid conflicts.

   setenv JLAB_ROOT /opt/jlab_software
   setenv JLAB_VERSION 1.2
   source $JLAB_ROOT/$JLAB_VERSION/ce/jlab.csh
   	

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

   > Common Environment Version:   (Tue, 3 Feb 2015)
   > Running as ungaro on Maurizios-Mac-Pro.local
   > OS Release:    Darwin_macosx10.8-x86_64-gcc4.2.1
   > JLAB_ROOT set to:     /opt/jlab_software
   > /opt/jlab_software/devel/Darwin_macosx10.8-x86_64-gcc4.2.1 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


5. Run the installation scripts for the packages you wish to install:

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