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

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

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

• 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

• 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