Changes between Version 23 and Version 24 of Documentation/UserGuide/InstallingORCHIDEE


Ignore:
Timestamp:
2020-02-28T10:41:00+01:00 (4 years ago)
Author:
mmcgrath
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentation/UserGuide/InstallingORCHIDEE

    v23 v24  
    1 = How to install ORCHIDEE on an linux pc (Ubuntu or Fedora distribution) = 
     1= How to install ORCHIDEE on a Linux PC (Ubuntu or Fedora distribution) = 
    22[[PageOutline]] 
    33 
    4 * See here the general method on how to install ORCHIDEE offline on an new machine: https://forge.ipsl.jussieu.fr/igcmg_doc/wiki/DocBenv#HowtousetheIPSLmodelsandtoolswithalocalPC 
    5 * Below on this page, see more details about installing libraries and ORHCIDEE offline with gfortran 
    6 * If you have an account at LSCE, IDRIS or TGCC computers follow the procedure to compile on a know computer as described here: [wiki:Documentation/UserGuide/InstallingORCHIDEEBasic]''' 
     4Author: D: Solyga 
     5Last revision: 2020/02/28, M. McGrath 
     6 
     7* The general method on how to install the IGCM computing environment (which ORCHIDEE can run in) is found here: https://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Doc#Installaconfiguration 
     8* If you have an account at LSCE, IDRIS or the TGCC computers, follow the procedure to download and compile ORCHIDEE as described here: [wiki:Documentation/UserGuide/InstallingORCHIDEEBasic]''' 
     9* The text below contains more details about installing libraries and ORCHIDEE with gfortran on a personal Linux computer.  If the libraries already exist on your computer, you can may be able to use the above pages. 
    710 
    811This installation guide has been tested on a laptop computer using Ubuntu 16.04 version. 
    9 Softwares used : mpicc (C compiler with mpi libraries wrapped on it), mpifort (or mpif90) (Fortran 90 compiler with mpi libraries wrapped on it), subversion (version control system), netcdf 4.6.1 [[BR]] 
    10 Follow the steps and you will be able to compile and launch ORCHIDEE in sequential on a point to test it ! 
    11  
    12 ORCHIDEE can be installed on sequential or parallel mode. This installation is oriented for parallel installation. The installation requires few packages to be installed in the system before starting installation of ORCHIDEE. These are: 
     12Software used : mpicc (C compiler with mpi libraries wrapped into it), mpifort (or mpif90) (Fortran 90 compiler with mpi libraries wrapped on it), subversion (version control system), netcdf 4.6.1 [[BR]] 
     13Follow the steps below and you should be able to compile and launch ORCHIDEE on a single processor for a single site. 
     14 
     15ORCHIDEE can be installed in serial (single processor) or parallel (multiple processors) mode. This installation is oriented for parallel installation. One can always run ORCHIDEE with a single processor even if the compilation was done for a parallel mode, but the opposite is not true (a serial executable cannot be run on multiple processors).  The installation requires a few packages to be installed on the system before starting installation of ORCHIDEE. These are: 
    1316 
    1417* szlib 
    … …  
    2124 
    2225 
    23 The list of packages should be installed in the order of appearance, although these packages are usually available in many Linux distributions.  A common way to check can be done by checking if the netcdf installation has links to the other packages. 
     26The list of packages should be installed in the order listed above.  note that many of these packages come pre-installed on many Linux distributions.  A common way to check can be done by checking if the netcdf installation has links to the other packages. 
    2427 
    2528{{{ 
    … …  
    3033}}} 
    3134 
    32  
    33  
    34 == 1. Installing netcdf library == 
    35 NOTE : It is not longer possible to use netcdf 3 with ORCHIDEE due to the tag IOIPSL v2_2_4 which requires netcdf 4!!! 
     35If you do not have nc-config, then you must install the NetCDF library: 
     36 
     37== 1. Installing NetCDF library == 
     38NOTE : It is no longer possible to use NetCDF 3 with ORCHIDEE due to the tagged version of IOIPSL v2_2_4 which requires NetCDF 4. 
    3639 
    3740=== 1.a Package installation (not tested) === 
    38 Now, netcdf is available as a package for linux distribution. For Ubuntu, a package exists. Make sure that the netcdf is compiled with the same compiler as you'll compile ORCHIDEE (here gfotran compiler). This installation was not tested, 
    39 but if it is OK, go to step 2 ! 
     41NetCDF is currently available as a package for many Linux distributions. For Ubuntu, for example, a package exists. Make sure that the netcdf is compiled with the same compiler as with you'll compile ORCHIDEE (here, gfortan). This installation has not yet been tested, but try it (with apt-get or whatever package manager exists on your distribution).  If it works, go to step 2. 
    4042 
    4143 
    4244=== 1.b Manual installation === 
    4345 
    44 Installing netcdf is a bit tricky, since it requires link to libraries of other packages. A library is a set files comprising functions inside packages. Each package carry a set of functions defined in libraries. Current programs (in this case ORCHIDEE) rely on many packages working together, therefore, we need to link these packages during installation.  
     46Installing NetCDF without a package manager is a bit tricky, since it requires linking to libraries in other packages. A library is a set files comprising functions inside packages (for example, the NetCDF library has a function that enables you to read the information in a NetCDF file). Each package carry a set of functions defined in libraries. Current programs (in this case ORCHIDEE) rely on many packages working together, therefore, we need to link these packages during installation.  
    4547 
    4648Download netcdf-c :