==== Guide on running AtRIS on university clusters ====

=== Prep work ===

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

  - Access has to be requested and approved by a prof and the Instutes director ([[https://www.rz.uni-kiel.de/de/ueber-uns/dokumente/formulare/anmeldung/form3.pdf|Form]], more infos [[https://www.rz.uni-kiel.de/de/angebote/hiperf/linux-cluster-caucluster|here]]) . Once you have obtained your login credentials, you can login via ssh: <code|bash>
ssh supexXXX@caucluster.rz.uni-kiel.de
OR
ssh supexXXX@nesh-fe.rz.uni-kiel.de </code> 
  - The clusters have a lot of software libraries available, however in order to avoid conflicts, these have to be loaded as modules. With: <code|bash>
module avail
</code> We get to se what is currently available.
  - Load the following modules. **Check if the versions  have not changed!** <code|bash>module load gcc5.3.0
module load cmake3.4.3
module load python2.7.11
</code>
  - However, xercesc is not available as a module, so you need to download and compile it in your home directory: <code|bash>
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
</code>
  - now compile Geant4 in your home directory. Follow the instructions in [[atris:installation]], except for the build command which should be replaced with <code|bash>
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
</code> which will tell the compiler to use the previously built xerces-c installation. 
  - 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: <code|bash>
mkdir builddir
cd builddir
cmake -DCMAKE_CXX_COMPILER=g++ -DCMAKE_C_COMPILER=gcc ..
make -j8
</code>
  - 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.

=== Simulation ===

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

== caucluster ==


==nesh-fe==