Home Contact Us Site Map  
 
       
    next up previous contents
Next: 3.2.2 Method 2 - Up: 3.2 Obtaining the code Previous: 3.2 Obtaining the code   Contents


3.2.1 Method 1 - Checkout from CVS

If CVS is available on your system, we strongly encourage you to use it. CVS provides an efficient and elegant way of organizing your code and keeping track of your changes. If CVS is not available on your machine, you can also download a tar file.

Before you can use CVS, the following environment variable(s) should be set within your shell. For a csh or tcsh shell, put the following

% setenv CVSROOT :pserver:cvsanon@mitgcm.org:/u/gcmpack
in your .cshrc or .tcshrc file. For bash or sh shells, put:
% export CVSROOT=':pserver:cvsanon@mitgcm.org:/u/gcmpack'
in your .profile or .bashrc file.

To get MITgcm through CVS, first register with the MITgcm CVS server using command:

% cvs login ( CVS password: cvsanon )
You only need to do a ``cvs login'' once.

To obtain the latest sources type:

% cvs co MITgcm
or to get a specific release type:
% cvs co -P -r checkpoint52i_post  MITgcm
The MITgcm web site contains further directions concerning the source code and CVS. It also contains a web interface to our CVS archive so that one may easily view the state of files, revisions, and other development milestones:
http://mitgcm.org/source_code.html

As a convenience, the MITgcm CVS server contains aliases which are named subsets of the codebase. These aliases can be especially helpful when used over slow internet connections or on machines with restricted storage space. Table 3.1 contains a list of CVS aliases

Table 3.1: MITgcm CVS Modules
Alias Name Information (directories) Contained
MITgcm_code Only the source code - none of the verification examples.
MITgcm_verif_basic Source code plus a small set of the verification examples (global_ocean.90x40x15, aim.5l_cs, hs94.128x64x5, front_relax, and plume_on_slope).
MITgcm_verif_atmos Source code plus all of the atmospheric examples.
MITgcm_verif_ocean Source code plus all of the oceanic examples.
MITgcm_verif_all Source code plus all of the verification examples.


The checkout process creates a directory called MITgcm. If the directory MITgcm exists this command updates your code based on the repository. Each directory in the source tree contains a directory CVS. This information is required by CVS to keep track of your file versions with respect to the repository. Don't edit the files in CVS! You can also use CVS to download code updates. More extensive information on using CVS for maintaining MITgcm code can be found here . It is important to note that the CVS aliases in Table 3.1 cannot be used in conjunction with the CVS -d DIRNAME option. However, the MITgcm directories they create can be changed to a different name following the check-out:

   %  cvs co MITgcm_verif_basic
   %  mv MITgcm MITgcm_verif_basic


next up previous contents
Next: 3.2.2 Method 2 - Up: 3.2 Obtaining the code Previous: 3.2 Obtaining the code   Contents
mitgcm-support@dev.mitgcm.org
Copyright © 2002 Massachusetts Institute of Technology