A-INSTALL

#
# Version of PACKAGE MESONH "Open distribution"
#              PACK-MNH-V5-2-1
#              DATE : 02/05/2016
#              VERSION : MESONH MASDEV5_2 + BUG-1 
#
#  MAP
#
#        0) TWO WAYS OF DOWNLOADING MESONH
#      I-A) DOWNLOAD VIA THE WEB MESONH HOME PAGE
#      I-B) DOWNLOAD VIA CVS ANONYMOUS 
#       II) CONFIGURING THE MESONH PACKAGE
#      III) COMPILING/INSTALLING THE MESONH PACKAGE ON YOUR LINUX COMPUTER 
#       IV) RUN SOME "SMALL KTEST" EXAMPLES
#        V) RECOMPILING YOUR 'OWN' SOURCES ONLY 
#       VI) COMPILING/INSTALLING MESONH ON GENCI & ECMWF & METEO COMPUTERS
#      VII) "SCANDOLLAR" = SCRIPTING YOUR OWN PROCEDURES 
#
#     VIII) TROUBLE-SHOOTING
#           a) Segmentation violation -> problem of "stack size" limit
#           b) Compiler bug with "ifort 10.0.xxx" 
#
#       IX) OPTIONAL COMPILATION
#           a) MNH_NCWRIT for netcdf graphic output file 
#           b) MNH_FOREFIRE for forefire runs ( external package needed )
#           c) MNH_RTTOV for optional radiative computation
#           d) cleaning previous compiled version
#
#
#  0) TWO WAYS OF DOWNLOADING MESONH
#  =================================
#
#  MESONH sources and executables 
#  http://mesonh.aero.obs-mip.fr
#  are developed and maintained with the
#  CVS tools ( http://www.cvshome.org/ )
#
#  There are two ways to download the package of
#  MESONH containing :
#    - sources 
#    - makefiles
#    - precompile exe 
#    - graphic tools
#    - basic examples
#
#  The first way is for VERY BASIC USER OF MESONH 
#  via a download of a "tar ball" in the WEB site of MESONH
#
#  The second way is for USER/DEVELOPER of MESONH
#  via the use of the CVS tools and an access via anonymous
#  connection with "ssh" to the CVS REPOSITORY of the MESONH package 
# 
#
# REM: It is now strongly recommended, but it's not an obligation, 
#      for all users to use de CVS solution, because:
#
#      * It's far more easy for us ( support team ) to give you some assistance
#        in case of trouble ... as the CVS tool permits us to know exactly
#         what you have changed in the original PACKAGE
#
#      * It's much more easy for you to update to the last version ...  
#        or at least see the change made for BUGFIX directly on our installation .
#
#
#  So here are explained the two ways <=> mutually exclusif 
#
#
^L
# I-A) DOWNLOAD VIA THE WEB MESONH HOME PAGE
# ==========================================
#
# With your preferred web browser go to the MESONH WEB SITE
# 
#  http://mesonh.aero.obs-mip.fr/mesonh
#     ---> Download
#           ---> CVS MESONH
#
# or directly
#
# http://mesonh.aero.obs-mip.fr/cgi-bin/mesonh_interne/viewcvs.cgi/MNH-VX-Y-Z
#
# in the field  "Show files using tag:" 
#
#    ---> select "PACK-MNH-V5-2-1"
#
# and then download the file "PACK-MNH-VX-Y-Z.tar.gz" by the link 
#
#    --> Download tarball
#
# Then untar the file "PACK-MNH-VX-Y-Z.tar.gz" where you want to,
# in your home directory for example:
#
 
cd ~
tar xvfz PACK-MNH-VX-Y-Z.tar.gz

#
# As the directory did not reflect the last version name move it 
# to the right one
#
 
mv MNH-VX-Y-Z MNH-V5-2-1
      
#
#  Process now to the chapter to configure the MesoNH 
#
# => II) CONFIGURING THE MESONH PACKAGE
#
^L
# I-B) DOWNLOAD VIA CVS ANONYMOUS
# ===============================
#
#    a) download the ssh key file "anoncvs.key" for anonymous connection 
#    -------------------------------------------------------------------
#
# With your preferred web browser go to the MESONH WEB SITE
# 
#  http://mesonh.aero.obs-mip.fr/mesonh
#     ---> Download
#           ---> CVS PACKAGE MESONH
#
# or directly
#
#   http://mesonh.aero.obs-mip.fr/cgi-bin/mesonh_interne/viewcvs.cgi/MNH-VX-Y-Z
#
# in the field  "Show files using tag:" 
#
#    ---> select "PACK-MNH-V5-2-1"
#
#   download the file "anoncvs.key"
#
#   by  :
#         1) a  "left-click" in the "Rev." column 
#       + 2) a  "right-click" on "download" 
#                   ---> save link to disk
#               (Warning :: don't copy the file content with  mouse copy/past 
#               because it contains binary-encoded information !!!)
#
#   then copy this file in your "${HOME}/.ssh/" directory
#
#   AND VERY IMPORTANT !!!
#   Modify the "read/write" permission with:
# 

chmod 600 anoncvs.key

#
#    b) download the config file "config.anoncvs_www"
#    ------------------------------------------------ 
#
#    For METEO-FRANCE & IDRIS & CINES & Laboratoire d'Aerologie computers ( IP address filter )
#    ==========================================================================================
#
#    download the file
#
#      -->  "config.anoncvs_www" 
#
#    Then concatened the file content with your "${HOME}/.ssh/config" file
#    ( this will define the computer alias "mesonh_anoncvs_www" for future ssh 
#      anonymous connections )

cd ${HOME}/.ssh
cat config.anoncvs_www >> config

#
#    FOR OTHER COMPUTERS USE special "config.anoncvs_www" 
#    ===================================================
#
#    if the computer, from which you download the MESONH sources,
#    is external to  METEO-FRANCE & IDRIS & CINES & Laboratoire d'Aerologie Laboratoire download this file 
#
#      --> "config.anoncvs_www_ext" 

cd ${HOME}/.ssh
cat config.anoncvs_www_ext >> config

#
#    OR for ECMWF computer ( cca ) download this config file 
#    ( to bypass the gateway filter ) 
#
#      --> "config.anoncvs_www_ecmwf"
#

cd ${HOME}/.ssh
cat config.anoncvs_www_ecmwf >> config

#
#    c) Setting CVS variables
#    ------------------------
#
#    set the CVS_RSH et CVSROOT like this
#    ( in your ".profile" or ".bashrc" file )
#

export CVS_RSH=ssh
export CVSROOT=:ext:mesonh_anoncvs_www:/home/cvsroot

#
#   c)  Checking out the "MESONH PACKAGE"  
#   -------------------------------------