Difference between revisions of "Solid install"

Revision as of 17:10, 28 June 2011

Instruction

Before anything, read general GEMC info at http://gemc.jlab.org

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.

To run interactive mode, install it locally.

If your computer system is redhat Enterprise Linux 5 (RHEL5) 64bit or 32bit which is the Jlab computer center supported "level X" system or Fedora 14 64bit, you can install the pre-compiled rpm packages.

For rpm installation, it's easy to use yum (refer to [1]). 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)

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.

If your computer system is none of above, you can install gemc in a virtual machine. I recommend vmplayer [2] and install CentOS 5 x64[3] which is the same system ifarm use. 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
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, that means you need to download the source code and compile it.

Besides, you also need geometry/field/banks files from the same source code tree.

So you need download gemc source tree. see how below.

Solid GEMC version control

GEMC source code is stored in SVN, to learn some basic about the version control system, refer to 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/ 

Current working version 4537, 2011/05/24 (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 check out this list [4]

here is a WebSVN browser

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 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,

To get the code specific to SoLID, solgemc:

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

solgemc Installation Instructions

solgemc installation outside JLAB

Other Solid software in svn

 https://jlabsvn.jlab.org/svnroot/solid

It includes other Solid related program, like event generator etc.