Docs: refer to illinois.edu, not uiuc.edu
[charm.git] / doc / charm++ / run.tex
index 621bd6e3ae6eb52c25693d08be93bab9b99df928..c62b6f30d5e290f880911ed8efc564efa3a6f02c 100644 (file)
@@ -1,5 +1,8 @@
+\section{Launching Programs with \kw{charmrun}}
+\label{charmrun}
+
 When compiling \charmpp{} programs, the charmc linker produces 
-both an executable file and a program called {\tt charmrun},
+both an executable file and an utility called {\tt charmrun},
 which is used to load the executable onto the parallel machine.
 
 To run a \charmpp{} program named ``pgm'' on four processors, type:
@@ -7,6 +10,10 @@ To run a \charmpp{} program named ``pgm'' on four processors, type:
 charmrun pgm +p4
 \end{alltt}
 
+Execution on platforms which use platform specific launchers, (i.e.,
+{\bf aprun}, {\bf ibrun}), can proceed without charmrun, or charmrun can be used
+in coordination with those launchers via the {\tt ++mpiexec} (see
+\ref{mpiexec} parameter.
 
 Programs built using the network version of \charmpp{} can be run
 alone, without charmrun.  This restricts you to using the processors
@@ -71,7 +78,7 @@ the network version:
 
 
 \item[{\tt ++mpiexec}]
-
+\label{mpiexec}
 Use the cluster's {\tt mpiexec} job launcher instead of the built in rsh/ssh
 method.
 
@@ -273,12 +280,12 @@ Here is a simple nodes file:
 
 \begin{alltt}
         group kale-sun ++cpus 1
-          host charm.cs.uiuc.edu ++shell ssh
-          host dp.cs.uiuc.edu
-          host grace.cs.uiuc.edu
-          host dagger.cs.uiuc.edu
+          host charm.cs.illinois.edu ++shell ssh
+          host dp.cs.illinois.edu
+          host grace.cs.illinois.edu
+          host dagger.cs.illinois.edu
         group kale-sol
-          host beauty.cs.uiuc.edu ++cpus 2
+          host beauty.cs.illinois.edu ++cpus 2
         group main
           host localhost
 \end{alltt}