Installation of G-RSM

  • The only requirement for getting the model is to add your name and email address to the user list. The major purpose of the user list is to notify you of upcoming workshops and updates.
  • Check if CVS is installed on your system by typing $ cvs. If your system does not have CVS, go to CVS page and install CVS.
  • Your system has to have C compiler, Fortran90 compiler, and adequate disk space. We usually use The Portland Group and Intel compilers on Linux machines.
  • Set environmental variable CVSROOT to the CVS server at COAPS.
    • e.g., setenv CVSROOT :pserver:anoncvs@elnino.coaps.fsu.edu:2401/usr/local/cvsuser/cpscvs
    • The password for user "anoncvs" is <return>
  • Add current directory "." to your PATH in .cshrc or equivalent.
  • Type $ cvs co INSTALL (Note all upper-case "INSTALL"). It will download "install" scripts and other necessary files.
  • "inst" script is removed. Type ./install to start your g-rsm session.
    • If you want to run previous versions, type "./install --version=XXXXX". XXXXX should be preroms for one earlier version. and XXXXX=palisades-01 for two earlier version. You may also use "./install --date=DATE" for version on DATE (yyyymmdd format). Type "./install --help" for more options.
    • The first question appears on the screen:
    • Install G-RSM library, source and run scripts from cvs repository
      The default version of this run is: trunk
      ./install --help for help. PRESS <ENTER> TO PROCEED.
Simply press <enter>
    • The 2-nd question:
    • Model choices
      gsm rsm crsm nhm roms scm gdas cpl ? [return=gsm]==>
Type gsm for global model, rsm for regional model. crsm for regional model forced by larger area regional model, roms for regional ocean model, scm for single column model, gdas for global data assimilation (Reanalysis 2 system) and 2 or more models separated by colon for coupling the models.
    • The 3-rd question:
    • Machine architecture:
      Type single/thread/mpi/hybrid [return=mpi]?==>
Type single for serial, thread for multiple-thread, mpi for parallel mpi and hybrid for thread/mpi hybrid computations. You need to have respective computer system to run the model on these modes. Thread normally require OPENMP and mpi require mpi libraries.
    • The 4-th question:
    • Institution
      Enter INSTITUTION, ? for list, [return=sio] ==>
Normally, you simply press <enter> to accept the default. If you type "?", you get list. If your institution name is not available, type sio for time being.
    • The 5-th question:
    • Machine CPU type
      Type MACHINE,  ? for list [return=linux].==>
Type machine name. Available names can be found by typing "?". Current list includes sgi origin ibmsp sun dec nec hp cray t90 t3e es linux mac.
    • The 6-th question:
    • Machine nickname
      Type the machine nickname [return=compas] ==>
Here, you provide the nickname of the machine. The examples are, compas, atlas, ranger, bluesky, etc.

    • The 7-th question:
    • Compiler
      Enter COMPILER, ? for list [return=pgi]. ==>
Here, you provide fortran compiler. For Linux machine, you have pgi and Intel choices. For other machines, compiler may be unique. Just accept the default.
    • The 8-th question:
    • Additional options:
      If you need to change
        mpi-version=1
        compile-in-64-bit=no
        linux-distribution=1
        distribution-vsn=0
      enter yes, else press enter or no==>
Normally, just press <enter>. If you need to use mpi2 or openmpi (this is mandatory for coupled model), 64 bit machine, unique linux distribution or distribution version, type yes and enter necessary information.
    • 9-th question:
    •  Model resolution specification
    • (1) gsm126k28
    • (2) gsm170k42
    • (3) gsm248k28
    • (4) gsm320k42
    • (5) gsm42k18
    • (6) gsm42k28
    • (7) gsm492k28
    • (8) gsm62k28
    • (9) gsm62k28i382
    • (10) gsm646k28
        • If there is no choice available, type 999 [return=8]==>

    • 10-th question
    • Type the number associated with your model dimension specification.
      If there is no choice available, type 999 [return=8]==>
If you are running your code in mpi, thread or hybrid mode, type in appropriate numbers.
    • 11-th question
    • Choice of run script:
      gsm: Which script do you want to run?
      amip cases cases_iri gsm gsm_inc gsmrt test [return=test]==>
Type the name of the model execution script to run. test script is good for testing the model first time on your machine (Testing RSM with test script, Testing CRSM (C2R) Part I, Testing CRSM (C2R) Part II, and Testing gdas script)
. Otherwise, chose appropriate ones. If you are downscaling reanalysis, select rsim (Running RSM with rsim script). For downscaling of global forecast, select rcases.
    • At this point, the script starts downloading necessary files, compile them and generate execution scripts.
    • Make sure stacksize is unlimited. See FAQ.
    • The installer will create three directories: libs, rsm/gsm/crsm, and rruns/gruns. libs directory is the same for GSM and RSM and it is independent of model resolution or serial/mpi. The main source code directory rsm/gsm/crsm is dependent on model resolution and serial/mp
    • If installation/compilation fails, try the page (**Try correcting installation problems**) . Then continue installation by typing "./install --continue".

If you want to know what the script install does, see what install does?