= MESSy/CLaMS: Installation =

The MESSy development repository is located on the DKRZ server https://gitlab.dkrz.de/MESSy/MESSy

 * Download the source code:

 To download the MESSy source code from the DKRZ server, one needs an account on this server and access to the repository given by the maintainer Patrick Jöckel (Patrick.Joeckel@dlr.de). For that one needs to create first an account at DKRZ from https://luv.dkrz.de, then join the existing project "853 ESCIMo" and login once into the GitLab server https://gitlab.dkrz.de with the user id defined by the previous process. Then ask Patrick Jöckel to be added to the MESSy project group on the GitLab server. The ssh keys should be uploaded to this GitLab Server. <<BR>><<BR>>

 Then the source code can be downloaded by:
 {{{
git clone git@gitlab.dkrz.de:MESSy/MESSy.git  [target-directory]
 }}}

 Outgoing ssh communication from JURECA/JUWELS is currently blocked. <<BR>> The source code can be downloaded to these systems via https (with userid and password): 
 {{{
git clone https://gitlab.dkrz.de/MESSy/MESSy.git [target-directory]
}}}

 If the MESSy code is already installed by ssh, it is possible to switch the gitlab server access to https by
 {{{
git remote set-url origin https://gitlab.dkrz.de/MESSy/MESSy.git
}}} 
 For access, one needs to use the DKRZ user number and password. <<BR>> <<BR>>

 On JUWELS there is '''only a small HOME disk quota'''. Please use the filesystem '''PROJECT''' for source code and applications.<<BR>><<BR>>

 * On JURECA/JUWELS load the following modules:
 {{{
module load Intel
module load ParaStationMPI
module load netCDF-Fortran
 }}}

 Information about module usage on '''JSC supercomputers''' can be found [[ https://apps.fz-juelich.de/jsc/hps/juwels/software-modules.html | here ]].

 * On IEK-7-Cluster add the bin subdirectory of the installation directory of MPICH library to your path: 
 {{{
PATH=/usr/nfs/software/icg1/local/mpich-3.2.1-ifort-18.0.3/bin:$PATH
export PATH
}}}

 * Create and run ''configure'' file in messy main directory:
 {{{
autoconf
configure
 }}}

 * In case of development, i.e. small changes in single routines, re-compilation could also speeded up significantly by switching off the version control in the configure before (once):
 {{{
configure --disable-VCSTAG
 }}}

 * For compilation with debug options run configure with RUNMODE=DEBUG:
 {{{
configure RUNMODE=DEBUG
 }}}


 * Compile all (in messy main directory), create executable '''bin/echam5.exe''':
 {{{
make [-j8]
 }}}
 
 
 * Compile only basemodel CLaMS (in messy main directory), create executable '''bin/clams.exe''' :
 {{{
make [-j8] mbm target=clams
 }}}