Differences between revisions 4 and 22 (spanning 18 versions)

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

-  ⇤ ← Revision 4 as of 2020-06-08 11:51:04 → 
  Size: 1785
  Editor: NicoleThomas
  Comment:
+   ← Revision 22 as of 2025-02-06 12:18:55 → ⇥
  Size: 2732
  Editor: NicoleThomas
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 16:
-git clone https://jugit.fz-juelich.de/clams/clams-git.git [target-directory]

git clone https://jugit.fz-juelich.de/clams/clams-support.git [target-directory]
+git clone https://gitlab.dkrz.de/MESSy/MESSy.git [target-directory]
-Line 21:
+Line 19:
+ 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>>
-Line 22:
+Line 25:
- * On JURECA load the following modules:
+ 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:
-Line 24:
+Line 29:
-module load intel-para
+module load Intel
module load ParaStationMPI
-Line 27:
+Line 33:
+ Information about module usage on '''JSC supercomputers''' can be found [[ https://apps.fz-juelich.de/jsc/hps/juwels/software-modules.html | here ]].
-Line 40:
+Line 48:
- * Compile all (in messy main directory):
+ * 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):
-Line 42:
+Line 50:
-make
+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]
-Line 45:
+Line 64:
- * Compile only basemodel CLaMS (in messy main directory):
+   * Compile only basemodel CLaMS (in messy main directory), create executable '''bin/clams.exe''' :
-Line 47:
+Line 67:
-make mbm target=clams
+make [-j8] mbm target=clams
-Line 49:
+Line 69: