Running GEOS 5 on a GMAO Desktop

This page will detail how to run the GEOS 5 model on a GMAO desktop. Both the single column model and the full model at 2 degrees (144x91 or c48) can be run starting with Ganymed-4_0

Prerequisites

You will need a desktop running a 64 bit version of Linux. In addition you will need access to /ford1/local and /ford1/share from your desktop. The ford1 disk contains the libaries, baselibs, and boundary conditions needed to run the model. GMAO support can help you with these two items. If you want to run the full model you will need one of the newer 8 core (with hyperthreading) machines with 8 GB of memory. The single column model can be run on one of the older machines with less cores and memory.

Checking Out and Building

Once you have satisfied the prerequisites you can check out and build the model. If you have not done so already you will need to upload the key for your local machine to progress. Then you will need to set up a tunnel to the cvsacl server to access the repository. NCCS has a detailed description of how to do this at https://progress.nccs.nasa.gov/trac/admin/wiki/CVSACL. You can upload your key at https://progress.nccs.nasa.gov/keyupload. You should be careful to concatenate all of your keys for the sites you access cvs from as everytime you upload a key it wipes out your previous key. For example if you are already accessing cvs from a different machine, copy the key from that machine to your desktop, put that in a file with your desktop key, and upload that file that contains both keys. Next you must add something like this to your .ssh/config file:

Host cvsacl
    HostName cvsacl.nccs.nasa.gov
    LocalForward 51234 localhost:22223

Host ctunnel
    HostName localhost
    Port 51234

Then to setup the tunnel you can simply ssh to cvsacl in a terminal:

$ ssh cvsacl

If you get denied access with a keyboard-interactive error contact NCCS as you may not have an account on progress and cvsacl even if you are using cvsacldirect on Discover. As long as this terminal is active you will be able to perform cvs commands and access the repository. Don't forget to set your CVSROOT environment variable. It should look like this:

:ext:user_name@ctunnel:/cvsroot/esma

Then checkout the model as usual:

$ cvs co -r Ganymed-4_0_BETA3 Ganymed

You then need to update a few files. Issue to following command in the src directory to update these 4 files

$ cvs upd -r mat-G40B3-desktop g5_modules Applications/GEOSgcm_App/gcm_convert.j Applications/GEOSgcm_App/gcm_setup Applications/GEOSgcm_App/scm_setup

Once this is done you can build the model as usual. Make sure that the environment variable ESMADIR is set, this will be path_model/GEOSagcm. Then

 
$ source $ESMADIR/src/g5_modules.

and issue the make. You can and should use the parallel build up to the number of cores you have available. To build using 4 cores you would issue:

$ make -j10 pinstall

Assuming everything goes right you should have a functional GEOS 5 model.