This guide will describe the steps necessary to run AtRIS on the university clusters “caucluster” and “nesh-fe”.

1. Access has to be requested and approved by a prof and the Instutes director (Form, more infos here) . Once you have obtained your login credentials, you can login via ssh:

   ssh supexXXX@caucluster.rz.uni-kiel.de
   OR
   ssh supexXXX@nesh-fe.rz.uni-kiel.de 

2. The clusters have a lot of software libraries available, however in order to avoid conflicts, these have to be loaded as modules. With:

   module avail

   We get to se what is currently available.

3. Load the following modules. Check if the versions have not changed!

   module load gcc5.3.0
   module load cmake3.4.3
   module load python2.7.11

4. However, xercesc is not available as a module, so you need to download and compile it in your home directory:

   wget http://ftp.halifax.rwth-aachen.de/apache//xerces/c/3/sources/xerces-c-3.2.2.tar.gz
   tar -xf xerces-c-3.2.2.tar.gz
   mv xerces-c-3.2.2 xerces-source
   mkdir xerces-install xerces-build
   cd xerces-build
   cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=../xerces-install -DCMAKE_BUILD_TYPE=Debug ../xerces-source
   make -j8
   make test
   make install

5. now compile Geant4 in your home directory. Follow the instructions in installation, except for the build command which should be replaced with

   cd ~/build/
   cmake -DCMAKE_CXX_COMPILER=g++ -DCMAKE_C_COMPILER=gcc -DCMAKE_INSTALL_PREFIX=../install -DXERCESC_ROOT_DIR=../xerces-install -DGEANT4_USE_GDML=ON -DGEANT4_INSTALL_DATA=ON ../source/
   make -j8
   make install

   which will tell the compiler to use the previously built xerces-c installation.

6. Now you need to clone AtRIS, prepare a build directory, source ~/geant4/install/bin/geant4.sh and build AtRIS. However this will throw an error message stating that glibcxx_3.4.20 is missing. You need to specify the compiler manually with:

   mkdir builddir
   cd builddir
   cmake -DCMAKE_CXX_COMPILER=g++ -DCMAKE_C_COMPILER=gcc ..
   make -j8

7. On some cluster systems several versions of the compiler modules are available. When using AtRIS make sure to load the same versions that you have used for compilation. Otherwise expect segmentation faults.

Unfortunately, the two systems use different batch frameworks, so we need to separate these instructions.