[PVFS2-CVS] commit by robl in pvfs2-1/doc: tuning.tex pvfs2-quickstart.tex pvfs2-guide.tex

[CVS commit program]

Update of /projects/cvsroot/pvfs2-1/doc
In directory parlweb:/tmp/cvs-serv27882

Modified Files:
	pvfs2-quickstart.tex pvfs2-guide.tex 
Added Files:
	tuning.tex 
Log Message:
start documenting some of the config file parameters


--- /dev/null	2003-01-30 05:24:37.000000000 -0500
+++ tuning.tex	2004-11-16 12:12:48.000000000 -0500
@@ -0,0 +1,20 @@
+\section{Tuning PVFS2}
+\label{sec:tuning}
+
+The default settings -- those provided by \texttt{pvfs2-genconfig} --
+will give correct behavior and decent performance.   You can use more
+aggressive settings that will yield better performance, but you should
+understand the consequences of altering the defaults.
+
+\subsection{Sync Mode}
+
+The easiest way to see an improvement in performance is to set the
+\texttt{TroveSyncMeta} and \texttt{TroveSyncData} attributes to ``no''
+in the \texttt{<StorageHints>} section.  If those attributes are set to
+``no'' then Trove will read and write data from a cache and not the
+underlying file.  Performance will increase greatly, but if the server
+dies at some point, you could lose data.  At this point in PVFS2
+development, server crashes are rare outside of hardware failures.
+PVFS2 developers should probably leave these settings to ``yes''.  If
+PVFS2 hosts the only copy of your data, leave these settings to ``yes''.
+Otherwise, give ``no'' a shot.

Index: pvfs2-quickstart.tex
===================================================================
RCS file: /projects/cvsroot/pvfs2-1/doc/pvfs2-quickstart.tex,v
diff -u -w -p -u -r1.28 -r1.29
--- pvfs2-quickstart.tex	12 Oct 2004 16:56:01 -0000	1.28
+++ pvfs2-quickstart.tex	16 Nov 2004 17:12:48 -0000	1.29
@@ -234,6 +234,10 @@ Writing 1 server config file(s)... Done.
 Configuration complete!
 \end{verbatim}
 
+The generated config files will have conservative default values.  The PVFS2
+Users Guide has more information about the settings and the consequences of
+setting more aggressive, high performance values.
+
 \subsection{Starting the server}
 
 Before you run pvfs2-server for the first time, you must run it with a special 
@@ -511,6 +515,10 @@ Writing 8 server config file(s)... Done.
 
 Configuration complete!
 \end{verbatim}
+
+The generated config files will have conservative default values.  The PVFS2
+Users Guide has more information about the settings and the consequences of
+setting more aggressive, high performance values.
 
 We have now made all the config files for an 8-node storage cluster:
 \begin{verbatim}

Index: pvfs2-guide.tex
===================================================================
RCS file: /projects/cvsroot/pvfs2-1/doc/pvfs2-guide.tex,v
diff -u -w -p -u -r1.3 -r1.4
--- pvfs2-guide.tex	29 Sep 2004 18:51:29 -0000	1.3
+++ pvfs2-guide.tex	16 Nov 2004 17:12:48 -0000	1.4
@@ -61,5 +61,8 @@
 \newpage
 \input{code-tree.tex}
 
+\newpage
+\input{tuning.tex}
+
 \end{document}