[cig-commits] r19342 - in seismo/3D/SPECFEM3D_GLOBE/trunk: doc/USER_MANUAL setup

[dkomati1 at geodynamics.org]

Author: dkomati1
Date: 2012-01-09 09:15:03 -0800 (Mon, 09 Jan 2012)
New Revision: 19342

Modified:
   seismo/3D/SPECFEM3D_GLOBE/trunk/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf
   seismo/3D/SPECFEM3D_GLOBE/trunk/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
   seismo/3D/SPECFEM3D_GLOBE/trunk/setup/constants.h.in
Log:
updated the description of LOCAL_PATH_IS_ALSO_GLOBAL


Modified: seismo/3D/SPECFEM3D_GLOBE/trunk/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.pdf
===================================================================
(Binary files differ)

Modified: seismo/3D/SPECFEM3D_GLOBE/trunk/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex
===================================================================
--- seismo/3D/SPECFEM3D_GLOBE/trunk/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex	2012-01-09 17:07:15 UTC (rev 19341)
+++ seismo/3D/SPECFEM3D_GLOBE/trunk/doc/USER_MANUAL/manual_SPECFEM3D_GLOBE.tex	2012-01-09 17:15:03 UTC (rev 19342)
@@ -272,14 +272,15 @@
 \item [{\texttt{FLAGS\_CHECK}}] Compiler flags for non-critical subroutines.
 \item [{\texttt{FLAGS\_NO\_CHECK}}] Compiler flags for creating fast, production-run
 code for critical subroutines.
-\item [{\texttt{LOCAL\_PATH\_IS\_ALSO\_GLOBAL}}] Set to \texttt{.false.}
-on most cluster applications. For reasons of speed, the (parallel)
-mesher typically writes a (parallel) database for the solver on the
-local disks of the compute nodes. Some systems have no local disks
-(e.g., BlueGene or the Earth Simulator) and other systems have a fast
-parallel file system, in which case this variable should be set to
-\texttt{.true.}. Note that this flag is not used by the mesher or
-the solver; it is only used for some of the post-processing.
+\item [{\texttt{LOCAL\_PATH\_IS\_ALSO\_GLOBAL}}] 
+If you want the parallel mesher to write a parallel (i.e., split) database for the solver on the
+local disks of each of the compute nodes, set this flag to \texttt{.false.}.
+Some systems have no local disks
+(e.g., BlueGene) and other systems have a fast
+parallel file system (LUSTRE, GPFS) that is easy and reliable to use, in which case this variable should be set to
+\texttt{.true.}. Note that this flag is not used by the mesher nor
+the solver; it is only used for some of the (optional) post-processing.
+If you do not know what is best on your system, setting it to \texttt{.true.} is usually fine; or else, ask your system administrator.
 \end{description}
 In addition to reading configuration variables, \texttt{configure}
 accepts the following options:

Modified: seismo/3D/SPECFEM3D_GLOBE/trunk/setup/constants.h.in
===================================================================
--- seismo/3D/SPECFEM3D_GLOBE/trunk/setup/constants.h.in	2012-01-09 17:07:15 UTC (rev 19341)
+++ seismo/3D/SPECFEM3D_GLOBE/trunk/setup/constants.h.in	2012-01-09 17:15:03 UTC (rev 19342)
@@ -66,8 +66,8 @@
 !*********************************************************************************************************
 
 ! if files on a local path on each node are also seen as global with same path
-! set to .true. typically on a shared-memory machine with a common file system
-! set to .false. typically on a cluster of nodes with local disks
+! set to .true. typically on a machine with a common (shared) file system, e.g. LUSTRE, GPFS or NFS-mounted /home
+! set to .false. typically on a cluster of nodes with local disks used to store the mesh (not very common these days)
 ! if running on a cluster of nodes with local disks, also customize global path
 ! to local files in create_serial_name_database.f90 ("20 format ...")
 ! Flag is used only when one checks the mesh with the serial codes