MITgcm

91f36c2dc6 Jean*0001 Update:
                0002 - testing scripts were no longer maintained here and have been
                0003   removed (around Dec 01, 2018).
                0004 - updated ones can be found in:
                0005    http://wwwcvs.mitgcm.org/viewvc/MITgcm/MITgcm_contrib/test_scripts/
                0006  and can be downloaded using CVS (http://mitgcm.org/public/using_cvs.html)
                0007 ------------------------------------------------------------------------
67d78f906e Ed H*0008
53c7d12349 Ed H*0009 =====  What is this?  =====
                0010
67d78f906e Ed H*0011 This directory is a collection of scripts and "crontab" entries mostly
                0012 intended for automated testing.  These scripts are not intended for
                0013 casual users.  If you have any questions about them or would like help
53c7d12349 Ed H*0014 writing one for your system, please contact the folks at:
                0015
                0016   MITgcm-support <MITgcm-support@mitgcm.org>
                0017
                0018 The convention is to name the directories here after the machine (or
                0019 "system" or site) where the scripts are known (or were known at one
                0020 time) to run.  Directories are used since each system may use multiple
                0021 different testing scripts.
                0022
                0023
                0024 =====  Why does it work this way?  =====
                0025
                0026 We're sorry that testreport does not work 100% automatically on all
                0027 MPI systems.  The problem is that the $MPIRUN or equivalent command is
                0028 different on almost every system.  Even on a single system, there may
                0029 be a variety of different $MPIRUN executables and each one might take
                0030 slightly different arguments, etc.  And these $MPIRUN issues are
                0031 further complicated by their (often *forced*) interactions with
                0032 whatever queueing system is in effect.  Many systems (eg. UCAR/NCAR)
                0033 will not allow a user to run any MPI programs--even small
                0034 ones--outside of their queueing system.  So the MPI programs *MUST* be
                0035 submitted through the queue.
67d78f906e Ed H*0036
53c7d12349 Ed H*0037 And this means that you have to get all of the queue system details
                0038 right including (but not limited to!):
67d78f906e Ed H*0039
53c7d12349 Ed H*0040   - $QRUN syntax (PBS vs LoadLeveler vs Condor vs ...)
                0041   - paths to /scratch disks for input and output
                0042   - shells and shell parameters
                0043   - "module" conventions (PATHs)
                0044   - etc-etc-etc...
67d78f906e Ed H*0045
53c7d12349 Ed H*0046 Unfortunately, these details can vary wildly from one system to the
                0047 next and often require per-user customizations.
67d78f906e Ed H*0048
53c7d12349 Ed H*0049 These example scripts are meant only as templates!
67d78f906e Ed H*0050