Vous êtes ici : Accueil / Recherches / Equipes / Echanges Côte-Large / Outils/Produits / GENESIS / Instructions

Instructions

Par ecola — Dernière modification 24/05/2015 15:01
sirocco-genesis installation hints

    Pre-requesites (usually available in Linux/Unix distribution packages):

     

    Sirocco-genesis requires some external packages, nothing really exotic, but some of them requiring the development package extension (so that include files, and not only libraries, will be available). If you don't have the privileges for installing system packages, ask your computer assistance to install those which are missing. Any missing packages will be detected and named by the configure command (in installation procedure). Just to avoid you to bump into each of them, one after the other, you can preliminarly check the following short list of pre-requisites:

    Xt and OpenMotif (devel), TIFF (devel), JPEG, gsl (devel), netcdf (devel), automake, gfortran/gcc/g++

     

    Packages name and installation procedures are of course not standard from one Linux distribution to another (life would be much too easy). Next sections will give you more information (hopefully reliable) on package names and installation procedures following the Linux distribution you use. See fixes section in case you experience troubles.

     

    ♦ SuSE:

    Xt and Motif packages: xorg-x11-libXt-devel openmotif-devel

    gsl package: gsl-devel

    TIFF package: libtiff-devel

    suggestion to install libtiff-devel: sudo zypper install libtiff-devel

    ♦ Ubuntu:

    Xt and Motif packages: libxt-dev libxext-dev x11proto-print-dev libmotif-dev
    gsl package: libgsl0-dev

    TIFF package: libtiff4-dev

    hdf5 package (if your netcdf requires it) :  libhdf5-serial-dev

    It is higly recommended to install xfonts-75dpi and xfonts-100dpi.

    suggestion to install libtiff4-dev: sudo apt-get install libtiff4-dev

    ♦ Redhat:

    Xt and Motif packages: libxt-dev libxext-dev x11proto-print-dev libmotif-dev

    ♦ Desbian:

     

    ♦ MacOS:

     

     

    ifort users warning:

    Due to fortran poorly managed standards, many ifort users have to re-compile the netcdf and possibly hdf libraries. Be careful that some user environment variable settings will not disturb access to standard system libraries and includes, especially for netcdf ones. Killers are: LDFLAGS, CPPFLAGS

     

    Installation (Mercurial depot installation)

     

    Instructions for compiling

    genesis can be compiled in various optional modes, it is highly recommended to dedicate a specific compiling directory for each of them need by the user. The following command will generate a Makefile using the -g option for compiling, hence enabling debugging or step-by-step execution in a development interface such as kdevelop:

    genesis-compiling> /.../genesis-depot/configure --with-debug --prefix=/.../genesis-compiling

    The following command will generate a standard Makefile using the -O3 option for compiling, hence enabling an optimized code:

    genesis-compiling> /.../genesis-depot/configure --prefix=/.../genesis-compiling

    Once the Makefile has been generated, you can compile and install genesis:

    tugo-compiling> make -j XXX
    tugo-compiling> make install

     

    Installation (tarball installation)

     

    Sirocco-genesis software distribution is based on auto-tools. In a  first step, sources need to be compiled (compilation step). In a second step, compiled objects can be installed in a specific directory(installation step).

    Installation can be done directly inside the distribution compiling  directory (where "make install" will automatically creating bin, lib and include sub-directories). However, it is a good practice to use a specific installation directory (not depending on software release number) so the updated executables (from future releases) will always be copied at the same location. Two options are suggested for the installation directory:

    • using /usr/local is a good choice (as /usr/local/bin is usually in your PATH environment variable), but it requires to have root privilege
    • using a specific one (such as /home/foo/.../sirocco-genesis), to be created by yourself if you are doing your very first installation

    If you choose first option, go to Procedure 1, else go to Procedure 2.

     

    Procedure 1 (installing software in /usr/local):

     

    step 1: get sirocco-genesis distribution

    1. download the last sirocco-genesis-6.0.XX tar-ball (sirocco-genesis--6.0.XX.tar.gz)
    2. decide for an compiling directory (where you will compile the source code, later named MY-COMPILATION-DIRECTORY), create it if does not exist
    3. copy or move sirocco-genesis--6.0XX tar-ball into MY-COMPILATION-DIRECTORY
    4. cd MY-COMPILATION-DIRECTORY

     

    step 2: compile and install step

    1. tar xvf sirocco-genesis-6.0.XX.tar.gz
    2. cd sirocco-genesis--6.0.XX
    3. aclocal
    4. ./configure --prefix=/usr/local
    5. make
    6. su root
    7. make install
    8. exit

     

        Procedure 2 (installing software in user-owned directory):

         

        step 1: get sirocco-genesis distribution

        1. download the latest sirocco-genesis-6.0.XX tar-ball (sirocco-genesis--6.0.XX.tar.gz)
        2. decide for an compiling directory (where you will compile the source code, later named MY-COMPILATION-DIRECTORY), create it if does not exist
        3. decide for an installation directory (later named MY-INSTALLATION-DIRECTORY), create it if does not exist
        4. copy or move sirocco-genesis--6.0XX tar-ball into MY-COMPILATION-DIRECTORY
        5. cd MY-COMPILATION-DIRECTORY

           

          step 2: compile and install step

          1. tar xvf sirocco-genesis-6.0.XX.tar.gz
          2. cd sirocco-genesis--6.0.XX
          3. aclocal
          4. ./configure --prefix=MY-INSTALLATION-DIRECTORY
          5. make
          6. make install

           

            Quick start:

             

            see upper page

             

            De-installation:

            1. cd MY-COMPILATION-DIRECTORY
            2. make uninstall

            Dysfunctioning fixes:

            *

            • sirocco-genesis run-time behavior and robustness might be sensitive to (compiling) optimization options. In case you experiment troubles, you can try your luck by getting through the installation procedures where configure options will be augmented as following:

            ./configure --prefix=MY-INSTALLATION-DIRECTORY CFLAGS=-g CXXFLAGS=-g

            • in some Unix/Linux distributions, default MOTIF package (possibly named lesstiff, motif, open-motif etc..) is more or less deficient. It is one of our usual suspects in case of software mal-functioning. Worth to investigate in case of troubles, and try to get a more recent update of this package...
            • you might be actually using a 32-bits system, either because your processor is truly of 32-bits type, or you have installed a 32-bits system on a 64-bits machine (for some mysterious reasons). It will mess-up memory exchange between C and Fortran routines in sirocco-genesis.  We do have a patch to fix this, please get into contact with us to get it
            • On some Linux distribution (typically Ubuntu or Fedora), some fonts will be missing and this will end with a crash at xscan's launch. You might try to install xfonts-75dpi or xfonts-100dpi to fix this issue

             

             


                Actions sur le document

                logo cnes logo IRD Logo université de Toulouse Logo université Paul Sabatier Logo CNRS
                Logo bibliothèque OBS Logo Observatoire Midi Pyrénées