Difference between revisions of "Solid install"

From Hall A Wiki
Jump to: navigation, search
(Solid GEMC version control)
(Link to new wiki)
 
(53 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Instruction ==
+
This page has been moved to [https://solid.jlab.org/wiki/index.php/install https://solid.jlab.org/wiki/index.php/install] in the new [https://solid.jlab.org/wiki SoLID Wiki].  Please do not edit this page.
  
Before anything, read general GEMC info at http://gemc.jlab.org
+
== Introduction ==
  
There are a couple way to run GEMC. You can always run it on ifarm for batch mode, but interactive mode will be slow because the OpenGL 3D rendering.  
+
You will need two things to run set of things for SoLID simulation:
 +
# [[#SoLID_GEMC|SoLID_GEMC]], which you will need no matter what,
 +
# [[#GEMC|GEMC]] (vanilla kind, easiest to setup) or [[#solgemc|solgemc]] (which uses GEMC as library, require a bit more work).
  
To run interactive mode, install it locally.
+
== SoLID_GEMC ==
  
Don't use 32 bit system.
+
solid_gemc is a collection of SoLID codes for using GEMC.  You need it no matter running vanilla GEMC or solgemc.
  
It's best if your computer system is redhat Enterprise Linux 5 (RHEL5) 64bit or Fedora 14 64bit (second choice), you can install the pre-compiled rpm packages.
+
You can obtain solid_gemc from SoLID SVN
  
  (do "uname -a" and "more /etc/redhat-release" to check your system version)
+
  svn co https://jlabsvn.jlab.org/svnroot/solid/solid_gemc
  
For rpm installation, it's easy to use yum (refer to [https://gemc.jlab.org/gemc/Documentation/Entries/2011/1/2_Install_gemc_on_Linux_with_yum.html]). If it somehow doesn't work, download them directly from http://www.jlab.org/12gev_phys/RPMS/ to a local directory, then install them manually as root to run "rpm -i *.rpm". (note: el5 and el5 client are same)
+
database_io  dir has geometry/field/banks ready to load into the mysql database
 +
script        dir has scripts to setup env and run the simulation code
 +
analysistool  dir has various packages for analyzing simulation result
  
If your computer system is scientific linux or centos, you can download and manual install those rpm for RHEL5 because they are essentially the same systems.
+
== GEMC ==
 +
 +
The framework use environmental variable JLAB_VERSION to control version
  
If your computer system is none of above, you can install gemc in a virtual machine. I recommend vmplayer [http://www.vmware.com/go/get-player] and install CentOS 5 x64[http://mirror.centos.org/centos/5/isos/] which is the same system ifarm use.
+
SoLID uses 1.0 version currently
Then you can use download rpms for redhat Enterprise Linux 5 and install them manually. Make sure to install vmware-tool in the CentOS guest system for better graphic performance.
+
  
there's a bug in el5 rpm package for now, after rpm installations, do following to have a workaround
+
The framework was tested on many platform, but for SoLID use, it's only fully tested on Redhat flavoured linux like CentOS, RHEL, Fedora so far
su -l
+
cd /usr/local/jlab_software/
+
ln -s Linux_CentOS5.3-x86_64-gcc4.1.2 Linux_RH-x86_64-gcc4.1.2
+
fc14 rpms are fine.
+
  
As solid is driving a lot of GEMC development and it's hard for the rpm package release to catch up. Just install rpm packages is not enough. You do need to get latest version of GEMC to run simulation for solid.
+
Detailed instruction is here [https://eic.jlab.org/wiki/index.php/Installation_of_framework installation of framework]
  
For your convenience,  here is a copy of the binary code compiled on ifarm (CentOS 5.3 64bit) which can be used on Fedora 14 64bit system also.
+
== version control (old)==
  
http://hallaweb.jlab.org/12GeV/SoLID/download/sim/gemc (based on SVN version )
+
'''see [[solid GEMC version historty ]] for the change log'''
  
If you want to compile the code your self, you need to check out the source code tree and compile it.
+
svn checkout by default always get the latest reversion.  If you want a specific reversion, add option "-r revision_number"
  
Besides, if you are working with any geometry/field/banks files, you need check out those files located within the same source code tree.
+
how to know your current copy reversion number: go to top svn directory, run "svn update", then run "svnversion"
 
+
See further info below.
+
 
+
== Solid GEMC version control ==
+
 
+
GEMC source code is stored in SVN, to learn some basic about the version control system, refer to [http://clasweb.jlab.org/wiki/index.php/Subversion Subversion help] and google more.
+
 
+
To checkout the svn, do this (it will ask your jlab user name and password)
+
 
+
svn co https://clas12svn.jlab.org/repos/trunk/clas12/gemc/production/
+
 
+
(how to get working version number: go to top svn directory, run svn update, then run svnversion)
+
 
+
'''(all svn sub directory in the wiki is relative to this location)'''
+
  
 
You'd better use a graphic svn client to get alerted once updates show up. I like "kdesvn" or you may check out this list [http://en.wikipedia.org/wiki/Comparison_of_Subversion_clients]
 
You'd better use a graphic svn client to get alerted once updates show up. I like "kdesvn" or you may check out this list [http://en.wikipedia.org/wiki/Comparison_of_Subversion_clients]
  
here is a [http://clasweb.jlab.org/websvn/prod/listing.php?repname=CLAS12&path=%2Ftrunk%2Fclas12%2Fgemc%2Fproduction%2F&sc=1#_trunk_clas12_gemc_production_ WebSVN browser]
+
== solgemc ==
 
+
== SoLID GEMC version history ==
+
 
+
'''''Current working version 4537, 2011/05/24'''''
+
 
+
== how to compile GEMC ==
+
 
+
To used latest feature of gemc, you need to compile the code yourself.
+
 
+
For now, Mauri is working on make the way to compile on general platform.
+
 
+
Some old instruction is [http://clasweb.jlab.org/wiki/index.php/Detailed_instructions here]
+
 
+
But it's very easy to compile on ifarm.
+
 
+
So go to ifarml6 or ifarml1 which are 64bit CentOS now
+
 
+
then run
+
svn co https://clas12svn.jlab.org/repos/trunk/clas12/gemc/production/
+
cd production
+
source /site/12gev_phys/ce/jlab.csh
+
scons OPT=1 -j4
+
 
+
Then you should have gemc binary code in the current directory.
+
 
+
You can run the newly built gemc on ifarm, but the OpenGL graphic will be slow.
+
 
+
Or if you already gemc rpm installed on your local machine which gives you many gemc dependent library, like root,geant4,evio,clhep etc, you can copy the newly built gemc to your local machine, then you can this new version of gemc. The assumption here is that the version of those external libraries has not changed, only the gemc source code change for this new build.
+
 
+
The binary code compiled on ifarm will certainly work on RHEL5, I have also used it on fedora14 x64 just fine too.
+
 
+
== SoLID built upon GEMC, using it as a toolkit. ==
+
  
 
Another way to run solid simulation is to use GEMC as library,
 
Another way to run solid simulation is to use GEMC as library,
Line 96: Line 51:
 
[[solgemc installation outside JLAB]]
 
[[solgemc installation outside JLAB]]
  
== Other Solid software in svn ==
+
== libsolgem ==
 +
 
 +
The library for digitizing GEM output is found in this repository
 +
 
 +
  svn checkout https://jlabsvn.jlab.org/svnroot/solid/libsolgem/
  
  https://jlabsvn.jlab.org/svnroot/solid
+
The database that corresponds to the GEM configuration in user_geometry3 : solid_gem
  
It includes other Solid related program, like event generator etc.
+
  https://hallaweb.jlab.org/12GeV/SoLID/download/sim/libsolgem/db_gemc.dat

Latest revision as of 15:39, 7 December 2020

This page has been moved to https://solid.jlab.org/wiki/index.php/install in the new SoLID Wiki. Please do not edit this page.

Introduction

You will need two things to run set of things for SoLID simulation:

  1. SoLID_GEMC, which you will need no matter what,
  2. GEMC (vanilla kind, easiest to setup) or solgemc (which uses GEMC as library, require a bit more work).

SoLID_GEMC

solid_gemc is a collection of SoLID codes for using GEMC. You need it no matter running vanilla GEMC or solgemc.

You can obtain solid_gemc from SoLID SVN

svn co https://jlabsvn.jlab.org/svnroot/solid/solid_gemc
database_io   dir has geometry/field/banks ready to load into the mysql database
script        dir has scripts to setup env and run the simulation code
analysistool  dir has various packages for analyzing simulation result

GEMC

The framework use environmental variable JLAB_VERSION to control version

SoLID uses 1.0 version currently

The framework was tested on many platform, but for SoLID use, it's only fully tested on Redhat flavoured linux like CentOS, RHEL, Fedora so far

Detailed instruction is here installation of framework

version control (old)

see solid GEMC version historty for the change log

svn checkout by default always get the latest reversion. If you want a specific reversion, add option "-r revision_number"

how to know your current copy reversion number: go to top svn directory, run "svn update", then run "svnversion"

You'd better use a graphic svn client to get alerted once updates show up. I like "kdesvn" or you may check out this list [1]

solgemc

Another way to run solid simulation is to use GEMC as library,

To get the code specific to SoLID, solgemc:

 svn checkout https://jlabsvn.jlab.org/svnroot/solid/solgemc

solgemc Installation Instructions

solgemc installation outside JLAB

libsolgem

The library for digitizing GEM output is found in this repository

 svn checkout https://jlabsvn.jlab.org/svnroot/solid/libsolgem/

The database that corresponds to the GEM configuration in user_geometry3 : solid_gem

  https://hallaweb.jlab.org/12GeV/SoLID/download/sim/libsolgem/db_gemc.dat