Debugging the GEOS-5 GCM

This page describes the process of building GEOS-5 Ganymed 1.0 on NCCS discover and NAS pleiades for debugging purposes.

It is assumed that you are able to build and run the model as detailed on the Ganymed 1.0 Quick Start page. Indeed, if you couldn't, you wouldn't know that you had an issue worth debugging.

Obtaining the model (optional)

If you need to, obtain the model doing so as described in the Ganymed 1.0 Quick Start page.

Compiling the model for debugging

To compile the model for debugging, first set up the environment for compiling by sourcing the g5_modules file located in GEOSagcm/src

$ cd GEOSagcm/src
$ source g5_modules

This should set up the modules for compiling:

$ module list
Currently Loaded Modulefiles:
 1) comp/intel-11.0.083                      3) lib/mkl-10.0.3.020
 2) mpi/impi-3.2.2.006                       4) other/SIVO-PyD/spd_1.6.0_gcc-4.3.4-sp1

Now compile the model for debugging by making with an option argument BOPT=g:

$ make install BOPT=g

This should take roughly 30 minutes to build.

Optional method of debug compiling with parallel_build.csh

You can also compile the model by using the parallel_build.csh script by using the optional -debug flag:

> ./parallel_build.csh -debug
g5_modules: Setting BASEDIR and modules for discover25

   ================
    PARALLEL BUILD 
   ================

The build will proceed with 10 parallel processes on 12 CPUs.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
LOG and info will be written to the src/BUILD_LOG_DIR directory.
Do the following to check the status/success of the build:

  cd BUILD_LOG_DIR
  ./gmh.pl [-v] LOG[.n]

Note: Check the latest version of LOG for the most recent build info.



Sp Code|  Org  | Sponsor            | Research
-------+-------+--------------------+----------------------------------
 g0620 | 610.1 | Michele Rienecker  | GMAO - Systems and Data Synthesis

select group: [g0620] 
qsub -W group_list=g0620 -N parallel_build -l select=1:ncpus=12:mpiprocs=10:proc=west -l walltime=1:00:00 -S /bin/csh -V -j oe ./parallel_build.csh
1203711.pbsa1
unset echo
1203711.pbsa1   mathomp4 debug    parallel_b    --    1  12 3892mb 01:00 Q   -- 

As the output states, you can monitor the progress of the job in the BUILD_LOG_DIR directory. (Note: This output will be slightly different depending on the Project Code and Username.)