Changes between Version 22 and Version 23 of doc/install

Timestamp:

Sep 15, 2010 9:08:45 AM (14 years ago)

Author:

witha

Comment:

--

doc/install

@@ -93 +93 @@
 }}}
 The second call also copies the PALM scripts (like '''mrun''' and '''mbuild''') to the remote host.
+
+=== Pre-Compilation of PALM Code ===
+
+To avoid the re-compilation of the complete source code for each model run, PALM willl be pre-compiled once on the remote host by again using the script '''mbuild'''. Due to the use of FORTRAN modules in the source code, the subroutines must be compiled in a certain order. Therefore the so-called ''make'' mechanism is used (see the respective man-page of the Unix operating system), requiring a {{{Makefile}}}, in which the dependencies are described. This file is found in subdirectory {{{trunk/SOURCE}}}, where also the PALM code is stored. The compiled sources (object files) are stored on the remote computer in the default directory {{{~/palm/current_version/MAKE_DEPOSITORY_<block_descriptor>}}}, where {{{<block_descriptor>}}} is composed of the third (and fourth, if existing) column of the respective block in the configuration file (e.g. {{{lcsgih_parallel}}} for HLRN).
+
+The pre-compilation for the remote host (here the SGI-ICE system of HLRN) is done by
+mbuild -h lcsgih  
+
+mbuild will prompt some queries, which must all be answered "y" by the user. The compiling process will take some time. mbuild transfers the respective compiler calls to the remote host where they are carried out interactively. You can follow the progress at the terminal window, where also error messages are displayed (hopefully not for this standard installation). By just entering
+
+    mbuild
+
+PALM will be (consecutively) pre-compiled for all remote hosts listed in the configuration file. If you want to compile for the local host only, please enter
+
+mbuild -h lcmuk