Icarus 3.4 Quick Start: Difference between revisions
Copied from Icarus 3.3 Quick Start, revision 4220 |
|||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
This page describes the minimum steps required to build and run GEOS-5 Icarus 3. | This page describes the minimum steps required to build and run GEOS-5 Icarus 3.4 on NCCS discover and NAS pleiades. '''You should successfully complete the steps in these instructions before doing anything more complicated. Also, it is helpful to read this page in its entirety before starting.''' | ||
'''Back to [[GEOS-5 Documentation for Icarus 3. | '''Back to [[GEOS-5 Documentation for Icarus 3.4]]''' | ||
== How to Obtain GEOS-5 and Compile Source Code == | == How to Obtain GEOS-5 and Compile Source Code == | ||
| Line 31: | Line 31: | ||
where ''USERID'' is, of course, your repository username, which should be the same as your NASA and NCCS username. Then, issue the command: | where ''USERID'' is, of course, your repository username, which should be the same as your NASA and NCCS username. Then, issue the command: | ||
cvs co -r Icarus- | cvs co -r Icarus-3_4 GEOSagcm | ||
This should check out the latest stable version of the model from the repository and create a directory called <code>GEOSagcm</code>. | This should check out the latest stable version of the model from the repository and create a directory called <code>GEOSagcm</code>. | ||
| Line 68: | Line 68: | ||
First, you need to set <code>ESMADIR</code>. For example, if your <code>src/</code> directory is: | First, you need to set <code>ESMADIR</code>. For example, if your <code>src/</code> directory is: | ||
/discover/nobackup/mathomp4/Models/Icarus- | /discover/nobackup/mathomp4/Models/Icarus-3_4/GEOSagcm/src | ||
then you should set: | then you should set: | ||
setenv ESMADIR /discover/nobackup/mathomp4/Models/Icarus- | setenv ESMADIR /discover/nobackup/mathomp4/Models/Icarus-3_4/GEOSagcm | ||
Next, | Next, we need to source <code>g5_modules</code> with: | ||
source g5_modules | source $ESMADIR/src/g5_modules | ||
This will set up the build environment. If you then type | This will set up the build environment. If you then type | ||
| Line 93: | Line 93: | ||
If this all worked, then type: | If this all worked, then type: | ||
cd $ESMADIR/src | |||
gmake install | gmake install | ||
| Line 131: | Line 132: | ||
Spaces are ok here. It will then ask for the source code version tag to associate with the model -- you should hit enter for the default: | Spaces are ok here. It will then ask for the source code version tag to associate with the model -- you should hit enter for the default: | ||
Enter an Experiment Source Tag for History (Default: Icarus- | Enter an Experiment Source Tag for History (Default: Icarus-3_4): | ||
Hit enter for the default to the next question: | Hit enter for the default to the next question: | ||
| Line 227: | Line 228: | ||
The <code>umask 022</code> is not strictly necessary, but it will make the various files readable to others, which will facilitate data sharing and user support. Your home directory <code>~''USERID''</code> is also inaccessible to others by default; running <code>chmod 755 ~</code> is helpful. | The <code>umask 022</code> is not strictly necessary, but it will make the various files readable to others, which will facilitate data sharing and user support. Your home directory <code>~''USERID''</code> is also inaccessible to others by default; running <code>chmod 755 ~</code> is helpful. | ||
Copy the restart (initial condition) files and associated <code>cap_restart</code> into ''EXPDIR''. You can get an arbitrary set of restarts by copying the contents of the directory <code>/discover/nobackup/mathomp4/Restarts- | Copy the restart (initial condition) files and associated <code>cap_restart</code> into ''EXPDIR''. You can get an arbitrary set of restarts by copying the contents of the directory <code>/discover/nobackup/mathomp4/Restarts-I30/nc4/Reynolds/c48</code>, containing 2-degree cubed sphere restarts from April 14, 2000, and their corresponding <code>cap_restart</code>. | ||
The script you submit, <code>gcm_run.j</code>, is in ''HOMEDIR''. It should be ready to go as is. The parameter END_DATE in <code>CAP.rc</code> can be set to the date you want the run to stop. Submit the job with <code>sbatch gcm_run.j</code>. You can keep track of it with <code>squeue</code> or <code>squeue -u ''USERID''</code>, or follow stdout with <code>tail -f ''EXPDIR''/slurm-''JOBID''.out</code>, ''JOBID'' being returned by <code>sbatch</code> and displayed with <code>squeue</code>. Jobs can be killed with <code>scancel ''JOBID''</code>. | The script you submit, <code>gcm_run.j</code>, is in ''HOMEDIR''. It should be ready to go as is. The parameter END_DATE in <code>CAP.rc</code> can be set to the date you want the run to stop. Submit the job with <code>sbatch gcm_run.j</code>. You can keep track of it with <code>squeue</code> or <code>squeue -u ''USERID''</code>, or follow stdout with <code>tail -f ''EXPDIR''/slurm-''JOBID''.out</code>, ''JOBID'' being returned by <code>sbatch</code> and displayed with <code>squeue</code>. Jobs can be killed with <code>scancel ''JOBID''</code>. | ||
| Line 249: | Line 250: | ||
---- | ---- | ||
'''Back to [[GEOS-5 Documentation for Icarus 3. | '''Back to [[GEOS-5 Documentation for Icarus 3.4]]''' | ||
Contact Matthew Thompson at GMAO with questions and comments | Contact Matthew Thompson at GMAO with questions and comments | ||