--- manual/s_getstarted/text/getting_started.tex 2004/04/08 02:24:23 1.23
+++ manual/s_getstarted/text/getting_started.tex 2004/06/04 15:32:38 1.25
@@ -1,4 +1,4 @@
-% $Header: /home/ubuntu/mnt/e9_copy/manual/s_getstarted/text/getting_started.tex,v 1.23 2004/04/08 02:24:23 edhill Exp $
+% $Header: /home/ubuntu/mnt/e9_copy/manual/s_getstarted/text/getting_started.tex,v 1.25 2004/06/04 15:32:38 edhill Exp $
% $Name: $
%\section{Getting started}
@@ -666,17 +666,17 @@
\end{verbatim}
-\subsection{Using \textit{genmake2}}
+\subsection{Using \texttt{genmake2}}
\label{sect:genmake}
To compile the code, first use the program \texttt{genmake2} (located
-in the \textit{tools} directory) to generate a Makefile.
+in the \texttt{tools} directory) to generate a Makefile.
\texttt{genmake2} is a shell script written to work with all
``sh''--compatible shells including bash v1, bash v2, and Bourne.
Internally, \texttt{genmake2} determines the locations of needed
files, the compiler, compiler options, libraries, and Unix tools. It
-relies upon a number of ``optfiles'' located in the {\em
- tools/build\_options} directory.
+relies upon a number of ``optfiles'' located in the
+\texttt{tools/build\_options} directory.
The purpose of the optfiles is to provide all the compilation options
for particular ``platforms'' (where ``platform'' roughly means the
@@ -918,10 +918,36 @@
Sightly more complicated scripts may be needed for many machines
since execution of the code may be controlled by both the MPI
library and a job scheduling and queueing system such as PBS,
- LoadLeveller, Condor, or any of a number of similar tools.
+ LoadLeveller, Condor, or any of a number of similar tools. A few
+ example scripts (those used for our \begin{rawhtml} \end{rawhtml}regular
+ verification runs\begin{rawhtml} \end{rawhtml}) are available
+ at:
+ \begin{rawhtml}
+ \end{rawhtml}
+ {\footnotesize \tt
+ http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm\_contrib/test\_scripts/ }
+ \begin{rawhtml} \end{rawhtml}
\end{enumerate}
+An example of the above process on the MITgcm cluster (``cg01'') using
+the GNU g77 compiler and the mpich MPI library is:
+
+{\footnotesize \begin{verbatim}
+ % cd MITgcm/verification/exp5
+ % mkdir build
+ % cd build
+ % ../../../tools/genmake2 -mpi -mods=../code \
+ -of=../../../tools/build_options/linux_ia32_g77+mpi_cg01
+ % make depend
+ % make
+ % cd ../input
+ % /usr/local/pkg/mpi/mpi-1.2.4..8a-gm-1.5/g77/bin/mpirun.ch_gm \
+ -machinefile mf --gm-kill 5 -v -np 2 ../build/mitgcmuv
+\end{verbatim} }
+
\section{Running the model}