[cig-commits] commit 2272 by gassmoeller to /var/svn/dealii/aspect

[dealii.demon at gmail.com]

Revision 2272

Added a subsection about compiling ASPECT to a static executable.

U   trunk/aspect/doc/manual/manual.tex


http://www.dealii.org/websvn/revision.php?repname=Aspect+Repository&path=%2F&rev=2272&peg=2272

Diff:
Modified: trunk/aspect/doc/manual/manual.tex
===================================================================
--- trunk/aspect/doc/manual/manual.tex	2014-01-16 13:53:32 UTC (rev 2271)
+++ trunk/aspect/doc/manual/manual.tex	2014-01-17 12:40:25 UTC (rev 2272)
@@ -1255,7 +1255,28 @@
 result will be the file \url{doc/doxygen/index.html} that is the starting
 point for exploring the documentation.
 
+\subsection{Compiling a static spect{} executable}
+spect{} defaults to a dynamically linked executable, which saves disk space and build time. In some circumstances however, it is preferred to generate a statically linked executable that incorporates all used libraries. This need may arise on large clusters on which libraries and loaded modules/variables on login nodes may be different from the ones available on compute nodes. The general build procedure in such a case equals the above explained instructions with the following differences:
+egin{enumerate}
+\item 	extit{Trilinos}: Add the following lines to your cmake call:
+egin{verbatim}
+ -DBUILD_SHARED_LIBS=OFF
+ -DTPL_FIND_SHARED_LIBS=OFF
+\end{verbatim}
+\item 	extit{\pfrst{}:} Change items "--enable-shared" to "--enable-static" in p4est-setup.sh lines 83 and 97.
+\item 	extit{\dealii{}:} Add the following lines to your call to cmake:
+egin{verbatim}
+ -DDEAL_II_STATIC_EXECUTABLE=ON
+\end{verbatim}
+\item 	extit{spect{}:} If everything above is set up correctly, there is no need for any configuration change to aspects build procedure. You should see the following cmake output from spect{}:
+egin{verbatim}
+-- Creating a statically linked executable
+-- Disabling dynamic loading of plugins from the input file
+\end{verbatim}
+\end{enumerate}
 
+The here mentioned build was tested on a Cray XC30 cluster, which was set up for default static compiling and linking. On machines that default to dynamic linking additional compiler and/or linker flags may be required (e.g. "-fPIC" / "--static"). In case of questions send an email to the mailing list.
+
 \section{Running spect}
 \label{sec:running}