Difference between revisions of "Install the TELEMAC system"

From SourceWiki
Jump to navigation Jump to search
Line 23: Line 23:
 
The folder <code>config-template</code> .
 
The folder <code>config-template</code> .
  
When the configuration of systel.ini is done, one must create a configuration file for the compilation. This is done automatically when issuing the command:
+
When the configuration of <code>systel.ini</code> is done, one must create a configuration file for the compilation. This is done automatically when issuing the command:
 
<code><pre>cfgmak</pre></code>
 
<code><pre>cfgmak</pre></code>
This will create a file called <code>cfgmak.mak</code> in the same directory. <code>cfgmak.mak</code> should **not** be edited manually, any configuration change should be done in <code>systel.ini</code> and the command <code>cfgmak</code> will update <code>cfgmak.mak</code. accordingly.
+
This will create a file called <code>cfgmak.mak</code> in the same directory. <code>cfgmak.mak</code> should ''not'' be edited manually, any configuration change should be done in <code>systel.ini</code> and the command <code>cfgmak</code> will update <code>cfgmak.mak</code> accordingly.
  
 
== Multiple configuration ==
 
== Multiple configuration ==

Revision as of 08:57, 13 August 2007

It is possible to install the TELEMAC system in one go with subversion by checking out the meta project systel90-meta. This will pull from the server the full dependencies for ESTEL-3D and ESTEL-2D. This article describes how to download, configure and compile a full installation of the TELEMAC system for ESTEL.

Downloading the TELEMAC system

To download the code, it is recommended to use "subversion" and the meta project systel90-meta. From now on, we assume that the user wants to install the TELEMAC system into the systel90 folder located at /path/to/systel90/. The command to use is:

svn checkout http://source.ggy.bris.ac.uk/subversion/systel90-meta systel90

This will create a systel90 folder containing all necessary source files for the TELEMAC system. The typical folder tree obtained after downloading is shown at the bottom of this page.

Configuration

Before being able to compile the TELEMAC system, a few configuration steps are necessary.

Paths

The executable files for the TELEMAC systel are located in the bin/ directory of the TELEMAC tree. The directory needs to be added to the PATH variable of the user. Moreover, the TELEMAC launching scripts require the current directory (./) to be in the PATH as well. A typical entry in a user login file ( for instance .bashrc) would be:

PATH=./:/path/to/systel90/bin:$PATH
export PATH

systel.ini and cfgmak.mak

The folder config-template .

When the configuration of systel.ini is done, one must create a configuration file for the compilation. This is done automatically when issuing the command:

cfgmak

This will create a file called cfgmak.mak in the same directory. cfgmak.mak should not be edited manually, any configuration change should be done in systel.ini and the command cfgmak will update cfgmak.mak accordingly.

Multiple configuration

It is also possible to make use of several config directories, for instance to swap between version, compiler or operating system platform. This is done by pointing the environement variable SYSTELCFG to the relevant directory containing the configuration. For instance to use the configuration stored in config/, one would use:

export SYSTELCFG=/path/to/systel90/config1

The typical .bashrc for ESTEL shows how switching configurations can be done on the fly. Note that when using this approach, the command cfgmak needs to be re-issued if the systel.ini has been changed so that the file cfgmak.mak is rebuilt accordingly for compilation purposes.

Compilation

Final TELEMAC tree

  • systel90
    • bief
      • bief_v5p7
        • sources
      • bief_v5p8
        • sources
    • bin
    • config-template
    • damocles
      • damo_v5p7
        • sources
      • damo_v5p8
        • sources
    • estel2d
      • estel2d_v5p7
        • lib
        • sources
        • test.gb
      • estel2d_v5p8
        • lib
        • sources
        • test.gb
    • estel3d
      • estel2d_v5p7
        • sources
        • test.gb
      • estel2d_v5p8
        • sources
        • test.gb
    • parallel
      • parallel_v5p7
        • metis_distrib
        • sources
      • parallel_v5p8
        • metis_distrib
        • sources
    • paravoid
      • paravoid_v5p7
        • sources
      • paravoid_v5p8
        • sources
    • special
      • special_v5p7
        • sources
      • special_v5p8
        • sources
    • sisyphe
      • sisyphe_v5p7
        • lib
        • sources
        • sources_util
      • sisyphe_v5p8
        • lib
        • sources
        • sources_util
    • telemac2d
      • tel2d_v5p7
        • lib
        • sources
      • tel2d_v5p8
        • lib
        • sources