Install instruction from scratch

Please note: these instructions have been substantially changed due to the migration of the code repositories to SVN. Easiest would be to start a virgin installation instead of updating an existing one.

Install ILC software using ilcsoft-install

Required:

• JAVA
• mysql
• ROOT
• CMake (available from cmake.org. Compatibility problems with CMake 2.6 are resolved meanwhile, use cmake -Wno-dev to suppress non-critical warnings)

Define a base path where to install the ILC software (a whole dir tree will be created)

export ILC_BASEDIR=<your choice>

Get ilcinstall package

cd $ILC_BASEDIR
mkdir ilcinstall
cd ilcinstall
svn co http://svnsrv.desy.de/public/ilctools/ilcinstall/tags/v01-07
cd v01-07

Get the config file ilcsoft-v01-07_calice.cfg, which steers the installation of the packages required for CALICE. Some entries need to be adjusted to your system, see comments in file. There are now also templates to install optional packages such as MarlinUtil, please check the end of the config file.

The packages of ILCsoft have to be compiled in 32bit compatibility mode, make sure to point to the 32bit version of the required packages in the config file. When compiling on a 64bit architecture, you will have to set the CXXFLAG environment variable for appropriate compilation before launching ilcsoft-install. In recent versions, this is set in the ilcsoft-install config script.

ilcsoft-install -i ilcsoft-v01-07_calice.cfg

In the end, there will be a config file for the CMake build tool, called ILCSoft.cmake. Two patches by hand are necessary: change MARLIN_HOME to MARLIN_DIR and LCCD_HOME to LCCD_DIR before proceeding.

Install calice_userlib and calice_reco on top

Again, chose a base directory for the CALICE code tree:

export BASEDIR=<your choice>

Download calice_userlib and calice_reco (see the version table for details, use 'trunk' rather than 'tags/' for the HEAD)

cd $BASEDIR
mkdir calice_userlib && cd calice_userlib
svn co http://svnsrv.desy.de/public/calice_userlib/tags/v04-12

cd $BASEDIR
mkdir calice_reco && cd calice_reco
svn co http://svnsrv.desy.de/public/calice_reco/tags/v04-08

Next you need to create a build directory. You are free to chose a different pattern, though this seemed reasonable to me

cd $BASEDIR
mkdir build
mkdir build/calice_userlib
mkdir build/calice_reco
cp $ILC_BASEDIR/ILCSoft.cmake ./build

Now you're ready to compile and install. Install paths for calice_userlib and calice_reco have to be chosen. (I use $HOME/)

cd $BASEDIR/build/calice_userlib
cmake -C ../ILCSoft.cmake -DCMAKE_INSTALL_PREFIX=<path to install calice_userlib> ../../calice_userlib
gmake install
cd $BASEDIR/build/calice_reco
cmake -C ../ILCSoft.cmake -DCMAKE_INSTALL_PREFIX=<path to install calice_reco> -DCALICE_USERLIB_DIR=<install prefix of calice_userlib>/cmake -DBUILD_WITH_CLUSTERING=off ../../calice_reco
gmake install

Drop the -DBUILD_WITH_CLUSTERING=off option to build the clustering package within calice_reco. However, this requires MarlinUtil, which has to be enabled for installation by editing the ilcsoft-install script accordingly.

In order to save disk space, you can clean the build area (if your install path is outside):

rm -rf $BASEDIR/build/calice_userlib/*
rm -rf $BASEDIR/build/calice_reco/*

-- NielsMeyer - 15 Dec 2009 : change instructions for SVN checkout, update to ILCsoft version v01-07, latest CALICE tags
-- NielsMeyer - 3 Jul 2009 : update ILCsoft versions to be compatible with latest version of calice_reco
-- NielsMeyer - 29 Sep 2008