Software installation instructions (JLAB_VERSION vvversiontoreplaceee)

Linux:

• CentOS 7
• CentOS 8

Mac:

• Big Sur, Monterey

• Version 2.5
  
• Version 2.6
  

General Requirements:

• csh shell
• network connection to download the various packages during installation
• wget
• git
• cmake >= 3.16
• scons version >= 3
• mysql (including devel) and openssl
• qt version 5
• OpenGL

⌘ MAC OS specific requirements

You can install the dependencies with homebrew:



brew upgrade ; brew update
brew install wget cmake mysql qt@5 scons freeglut

		

🐧 Ubuntu (Debian-line) specific requirements

You can install the dependencies with apt-get:



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

🐧 Fedora (red-hat line) specific requirements

You can install the dependencies with dnf or yum (the mysql package name may vary depends on the OS, you can dnf yum search mysql to find out the available version):



dnf install gcc-c++ expat-devel zlib-devel libx11-devel mesa-libGLU-devel libXmu-devel mariadb-devel qt5-qttools-devel scons
		

Installation:

1. (Optional): create a file in your home directory:

   .jlab_software

   that contains one line only, with the packages you're interested in. The default (also works if .jlab_software is not present) is:

   
   banks ccdb clhep evio geant4 gemc glibrary hipo mlibrary mysql qt root scons xercesc
   			

   Only the packages inside .jlab_software will be considered when setting the environment.

   
   
2. Choose a place to install the software. This place will be called JLAB_ROOT. Create the dir and change ownership:
   
   A standard (but not necessary) choice for JLAB_ROOT is /opt/jlab_software:

   
   set JLAB_ROOT=/opt/jlab_software
   mkdir -p $JLAB_ROOT/vvversiontoreplaceee
   chown -R `whoami` $JLAB_ROOT
   			

3. Get the installation scripts:

   
   cd $JLAB_ROOT
   wget -c  http://www.jlab.org/12gev_phys/packages/sources/ceInstall/ceInstall_vvversiontoreplaceee.tar.gz
   tar -zxpf ceInstall_vvversiontoreplaceee.tar.gz --strip-components 1 -C vvversiontoreplaceee
   			 

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

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

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

   > Common Environment Version:   (Wed March 30 2022)
   > Running as ungaro on enpungarombp.jlab.org
   > OS Release:    Darwin_macosx12.3-clang13.1.6
   > JLAB_ROOT set to:     /opt/jlab_software
   > JLAB_SOFTWARE set to: /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6
   
   !! Attention:  BANKS  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/banks/1.8/bin  not found
   !! Attention:  CCDB  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/ccdb/ccdb-1.07.00/lib  not found
   !! Attention:  CLHEP  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/clhep/2.4.5.1/lib  not found
   !! Attention:  EVIO  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/evio/5.1/bin  not found
   !! Attention:  GEANT4  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/geant4/4.11.01/bin  not found
   !! Attention:  GEMC  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/gemc/2.9  not found
   !! Attention:  GLIBRARY  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/glibrary/1.0  not found
   !! Attention:  HIPO  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/hipo/1.4/lib/libhipo4.a  not found
   !! Attention:  MLIBRARY  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/mlibrary/1.5/lib  not found
   !! Attention:  MYSQL  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/mysql/lib  not found
   !! Attention:  QT    installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/qt/system/clang_64/lib  not found
   !! Attention:  ROOT  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/root/6.24.06/bin/root-config  not found
   !! Attention:  SCONS  installation check /opt/jlab_software/vvversiontoreplaceee/scons_bm/1.10/site_tools  not found
   !! Attention:  XERCESC  installation check /opt/jlab_software/vvversiontoreplaceee/Darwin_macosx12.3-clang13.1.6/xercesc/3.2.3/  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 corresponding warning log with a successful one.
   
   Notice: if you want to preserve some environment variables use the option "keepmine" :

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

5. Execute the go script for the packages you wish to install:

   
   cd $JLAB_ROOT/vvversiontoreplaceee/install
   
   ./go_clhep
   ./go_xercesc
   ./go_qt system
   (use ./go_qt to compile qt from scratch)
   ./go_geant4 
   ./go_sconsscript
   ./go_evio
   ./go_mysql
   ./go_ccdb
   ./go_mlibrary
   ./go_hipo
   ./go_glibrary
   ./go_gemc
   (use go_gemc 3.0 for gemc 3.0 installation)
   ./go_root system
   (use ./go_root to compile root from scratch)
   ./go_banks
   			

   Note: The order of the packages above reflect the packages dependencies
   
   

Typical installation times:

Package	Approx Installation Time
clhep	1-2 minutes
xercesc	2 minute2
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	20 seconds
mlibrary‡	2-3 minutes
gemc	2 minutes
root	25 minutes
banks	5 seconds
Total (system qt)	40 minutes
Total (qt from scratch)	1 hour

		setenv QT_VERSION 5.10.1
		source $JLAB_ROOT/devel/ce/jlab.csh keepmine