Changeset 230 for trunk/MESOSCALE_DEV/MANUAL/SRC/installation.tex

Timestamp:

Jul 15, 2011, 8:45:44 PM (13 years ago)

Author:

aslmd

Message:

MESOSCALE: user manual. some updates: reference namelist.input, env variables in the text, new figures for the new TEST CASE and the FAST CASE for newphys.

File:

• trunk/MESOSCALE_DEV/MANUAL/SRC/installation.tex (modified) (4 diffs)

trunk/MESOSCALE_DEV/MANUAL/SRC/installation.tex

@@ -76 +76 @@
 \section{Main installation of the model sources}
 
-\paragraph{Method 1: You were given a \ttt{LMD\_MM\_MARS.tar.gz} archive} Please set the environment variable \ttt{\$MOD} to point at the directory where you will install the model and define the environment variable \ttt{\$MMM} as \ttt{\$MOD/LMD\_MM\_MARS}. Copy the \ttt{LMD\_MM\_MARS.tar.gz} file in the \ttt{\$MOD} directory and extract the files. Then execute the \ttt{prepare} script that would do all installation tasks\footnote{Deflate the various compressed archives contained into \ttt{LMD\_MM\_MARS}, download the ARW-WRF sources from the web, apply a (significant) ``Martian patch" to these sources and build the structure of your \ttt{LMD\_MM\_MARS} directory} for you:
+\paragraph{Method 1: You were given a \ttt{LMD\_MM\_MARS.tar.gz} archive} Please set the environment variable \ttt{\$MESO} to point at the directory where you will install the model and define the environment variable \ttt{\$MMM} as \ttt{\$MESO/LMD\_MM\_MARS}. Copy the \ttt{LMD\_MM\_MARS.tar.gz} file in the \ttt{\$MESO} directory and extract the files. Then execute the \ttt{prepare} script that would do all installation tasks\footnote{Deflate the various compressed archives contained into \ttt{LMD\_MM\_MARS}, download the ARW-WRF sources from the web, apply a (significant) ``Martian patch" to these sources and build the structure of your \ttt{LMD\_MM\_MARS} directory} for you:
 %
 \begin{verbatim}       
-declare -x MOD=/disk/user/MODELS
-declare -x MMM=$MOD/LMD_MM_MARS
-cp LMD_MM_MARS.tar.gz $MOD
-cd $MOD
+declare -x MESO=/disk/user/MODELS
+declare -x MMM=$MESO/LMD_MM_MARS
+cp LMD_MM_MARS.tar.gz $MESO
+cd $MESO
 tar xzvf LMD_MM_MARS.tar.gz
-cd $MOD/LMD_MM_MARS
+cd $MESO/LMD_MM_MARS
 ./SRC/SCRIPTS/prepare  ## or simply ./prepare if the script is in LMD_MM_MARS
 \end{verbatim}
 
-\paragraph{Method 2: You were given a \ttt{svn} link \ttt{the\_link}} \emph{You must have Subversion (\ttt{svn}) installed on your system to follow this method}. Please use the name of our server repository combined to an \ttt{svn checkout} command to get the model sources\footnote{At this stage, it is essential to have registered to the WRF website (see foreword) because our server contains some part of the ARW-WRF sources.}. Please also set the environment variable \ttt{\$MOD} and \ttt{\$MMM}. The first download of the model sources could be a bit long. Compared to method~$1$, this method~$2$ using \ttt{svn} would allow you to easily get the latest updates and bug fixes done on the LMD Martian Mesoscale Model by the development team\footnote{If you are not interested by this feature, please replace the command line featuring \ttt{svn checkout} by this command line \ttt{svn export the\_link/LMDZ.MARS the\_link/MESOSCALE} }.
+\paragraph{Method 2: You were given a \ttt{svn} link \ttt{the\_link}} \emph{You must have Subversion (\ttt{svn}) installed on your system to follow this method}. Please use the name of our server repository combined to an \ttt{svn checkout} command to get the model sources\footnote{At this stage, it is essential to have registered to the WRF website (see foreword) because our server contains some part of the ARW-WRF sources.}. Please also set the environment variable \ttt{\$MESO} and \ttt{\$MMM}. The first download of the model sources could be a bit long. Compared to method~$1$, this method~$2$ using \ttt{svn} would allow you to easily get the latest updates and bug fixes done on the LMD Martian Mesoscale Model by the development team\footnote{If you are not interested by this feature, please replace the command line featuring \ttt{svn checkout} by this command line \ttt{svn export the\_link/LMDZ.MARS the\_link/MESOSCALE} }.
 
 \begin{verbatim}
@@ -95 +95 @@
 svn update LMDZ.MARS MESOSCALE
 cd MESOSCALE
-declare -x MOD=$PWD
-declare -x MMM=$MOD/LMD_MM_MARS
+declare -x MESO=$PWD  ## put absolute link in your .bashrc
+declare -x MMM=$MESO/LMD_MM_MARS
 ## to get latest updates later on
 cd the_name_of_your_local_destination_folder
@@ -107 +107 @@
 
 \sk
-Parallel computations with the Message Passing Interface (MPI) standard are supported by the LMD Martian Mesoscale Model. If you want to use this capability, you would have to add the installation of MPICH2 as a additional prerequisite. Once the installation is completed, it is required to define the environment variable \ttt{\$WHERE\_MPI} to point in your \ttt{mpich} \ttt{bin} directory, even if you added the \ttt{\$MOD/MPI/mpich2-1.0.8/bin} directory to your \ttt{\$PATH} variable. 
+Parallel computations with the Message Passing Interface (MPI) standard are supported by the LMD Martian Mesoscale Model. If you want to use this capability, you would have to add the installation of MPICH2 as a additional prerequisite. Once the installation is completed, it is required to define the environment variable \ttt{\$WHERE\_MPI} to point in your \ttt{mpich} \ttt{bin} directory, even if you added the \ttt{\$your_software_dir/MPI/mpich2-1.0.8/bin} directory to your \ttt{\$PATH} variable. 
 
 \begin{finger}
 \item \scriptsize Here is a brief ``how-to" to install MPICH2, although this surely does not replace reading carefully installation notes and choosing what installation suits best your system. Please download the current stable version of the sources (e.g. we choose here an old version \ttt{mpich2-1.0.8.tar.gz} to illustrate the commands) on the MPICH2 website \url{http://www.mcs.anl.gov/research/projects/mpich2} and install the MPICH2 utilities by the following commands:
 \begin{verbatim}
-mkdir $MOD/MPI
-mv mpich2-1.0.8.tar.gz $MOD/MPI
-cd $MOD/MPI
+mkdir $your_software_dir/MPI    
+mv mpich2-1.0.8.tar.gz $your_software_dir/MPI/
+cd $your_software_dir/MPI
 tar xzvf mpich2-1.0.8.tar.gz
 cd mpich2-1.0.8
@@ -120 +120 @@
 # please wait...
 make > mk.log 2> mkerr.log &
-declare -x WHERE_MPI=$MOD/MPI/mpich2-1.0.8/bin
+declare -x WHERE_MPI=$your_software_dir/MPI/mpich2-1.0.8/bin
 \end{verbatim}
 \normalsize