[Pvfs2-cvs] commit by kunkel in pvfs2/doc: pvfs2-quickstart.tex
REFERENCES pvfs2-faq.tex
CVS commit program
cvs at parl.clemson.edu
Wed May 23 16:48:59 EDT 2007
Update of /projects/cvsroot/pvfs2/doc
In directory parlweb1:/tmp/cvs-serv20193/doc
Modified Files:
Tag: pvfs2-kunkel-tas-branch
pvfs2-quickstart.tex REFERENCES pvfs2-faq.tex
Log Message:
Merge HEAD changes to TAS-branch.
Index: pvfs2-quickstart.tex
===================================================================
RCS file: /projects/cvsroot/pvfs2/doc/pvfs2-quickstart.tex,v
diff -p -u -r1.40 -r1.40.2.1
--- pvfs2-quickstart.tex 23 Oct 2006 18:54:50 -0000 1.40
+++ pvfs2-quickstart.tex 23 May 2007 20:48:59 -0000 1.40.2.1
@@ -965,14 +965,27 @@ needed.
\begin{verbatim}
prompt% tar xzf ~/src/mpich2-1.4.0p1.tar.gz # unpack mpich2 source
-prompt% cd mpich2-0.96p2/src/mpi/romio # change to ROMIO dir
+prompt% cd mpich2-1.4.0p1/src/mpi/romio # change to ROMIO dir
prompt% patch -p1 < ~/src/romio-<CORRECT_VERSION>.diff #apply patch
prompt% cd ../../.. # return to top of src
prompt%
\end{verbatim}
-In order to build MPICH2 with a ROMIO that speaks PVFS2, a few changes
-have to be made to the normal configure process. MPICH2 will need to
+In order to build MPICH2 with a ROMIO that speaks PVFS2, pass the
+\texttt{--with-pvfs2=PVFS\_PREFIX} option to configure. 'PVFS2\_PREFIX' is the
+prefix you gave to the PVFS configure script (e.g. /usr/local or
+/opt/packages/pvfs-2.6.0).
+
+\begin{verbatim}
+configure --with-pvfs2=PVFS_PREFIX [other flags]
+\end{verbatim}
+
+Now compile and install MPICH2 as you normally would. Applications accessing
+PVFS2 through MPI-IO will bypass the kernel interface and talk to PVFS2 servers
+directly.
+
+Please note: older versions of MPICH2 need a few changes
+to the normal configure process. MPICH2-1.0.4p1 and older will need to
know the path to the PVFS2 installation. Modify the {\tt CFLAGS},
{\tt LDFLAGS} and {\tt LIBS} environment variables.
@@ -980,18 +993,7 @@ know the path to the PVFS2 installation.
prompt% export CFLAGS="<other desired flags> -I/usr/local/pvfs2/include"
prompt% export LDFLAGS="-L/usr/local/pvfs2/lib"
prompt% export LIBS="-lpvfs2 -lpthread"
-prompt%
+prompt% configure --with-file-system=ufs+nfs+testfs+pvfs2 [other flags]
\end{verbatim}
-
-The MPICH2 configure script needs a some additional arguments to build
-ROMIO correctly. The {\tt enable-romio} flag builds ROMIO and the
-{\tt with-file-system} flag tells ROMIO which file systems to support.
-
-\begin{verbatim}
-configure --enable-romio --with-file-system=ufs+nfs+pvfs2 [other flags]
-\end{verbatim}
-
-Now compile and install MPICH2 as you normally would. Applications accessing
-PVFS2 through MPI-IO will bypass the kernel interface and talk to PVFS2 servers directly.
\end{document}
Index: REFERENCES
===================================================================
RCS file: /projects/cvsroot/pvfs2/doc/REFERENCES,v
diff -p -u -r1.4 -r1.4.34.1
--- REFERENCES 7 Feb 2006 17:10:37 -0000 1.4
+++ REFERENCES 23 May 2007 20:48:59 -0000 1.4.34.1
@@ -1,5 +1,9 @@
PVFS2:
+Ananth Devulapalli and Pete Wyckoff, "File creation strategies in a
+ distributed metadata file system," Proceedings of IPDPS'07, Long Beach,
+ CA, March 2007.
+
Weikuan Yu, Shuang Liang, Dhabaleswar K. Panda. "PVFS2 over Quadrics: Design,
Implementation and Performance Evaluation". Ohio State University Tecnhical
Report OSU-CISRC-12/04-TR6. Date Unknown
@@ -127,6 +131,11 @@ A. Sivasubramaniam, M. Vilayannur, P. H.
Performance of the POSIX I/O Interface to PVFS'', Proceedings of the 12th
Euromicro Conference on Parallel, Distributed and Network based Processing,
A Coruna, Spain, February 2004.
+
+Hsieh, J. Stanton, C. Ali, R, ``Performance evaluation of software RAID vs.
+ hardware RAID for Parallel Virtual File System", Ninth International
+ Conference on Parallel and Distributed Systems, December 2002.
+ http://ieeexplore.ieee.org/xpls/abs_all.jsp?arnumber=1183417
/* this one does mention a bit of pvfs2k */
"A Parallel Out-of-Core Computing System Using PVFS for Linux Clusters". Jianqi
Index: pvfs2-faq.tex
===================================================================
RCS file: /projects/cvsroot/pvfs2/doc/pvfs2-faq.tex,v
diff -p -u -r1.51 -r1.51.2.1
--- pvfs2-faq.tex 26 Oct 2006 18:31:04 -0000 1.51
+++ pvfs2-faq.tex 23 May 2007 20:48:59 -0000 1.51.2.1
@@ -65,6 +65,27 @@ The PVFS2 Guide (\url{http://www.pvfs.or
information on all of these components, plus a discussion of the system as a
whole, the code tree, and more.
+\subsection{What is the format of the PVFS version string?}
+\label{sec:version-string}
+PVFS uses a three-number version string: X.Y.Z. The first number (X)
+represents the high level design version of PVFS. The current design
+version is 2, and will likely remain there. The second number (Y) refers
+to the major version of the release. Major versions are incremented with
+new features, protocol changes, public API changes, and storage format
+changes. The third number (Z) refers to the minor version of the release,
+and is incremented primarily for bug fix releases.
+
+With our 2.6.0 release,
+we changed the release version and name from PVFS2 1.x.x, to PVFS 2.x.x.
+Users familiar with 'PVFS2' and had been using PVFS2 1.5.1
+will find the same software in PVFS version 2.6.0 or
+later (with updates and new features of course).
+
+Users of PVFS version 1 can still go to:
+\url{http://www.parl.clemson.edu/pvfs}, although we highly
+encourage you to upgrade to PVFS version 2, if you are still using
+version 1.
+
%
% SUPPORTED ARCHITECTURES
%
@@ -662,6 +683,7 @@ the page-cache and thus there is a real
Therefore users of the {\tt sendfile} system call are warned to be wary of this detail.
\subsection{Trove-dbpf metadata format version mismatch!}
+\label{sec:trove-migration}
In PVFS2-1.5.0 or newer the format of the metadata storage has change from
previous versions (1.4.0 or earlier). This affects users that have created
@@ -714,7 +736,7 @@ stress local file systems. They do not
workloads for which we designed PVFS2. Furthermore, because of their
serial nature, PVFS2 will be unable to deliver its full performance.
Instead try running a parallel file system benchmark like IOR
-(\url{http://www.llnl.gov/asci/purple/benchmarks/limited/ior/}).
+(\url{ftp://ftp.llnl.gov/pub/siop/ior/}).
\subsection{Why is program XXX so slow?}
@@ -1003,6 +1025,7 @@ Not at this time, no.
\subsection{Why does df show less free space than I think it should? What
can I do about that?}
+\label{sec:df-free-space}
PVFS2 uses a particular algorithm for calculating the free space on a file
system that takes the minimum amount of space free on a single server and
More information about the Pvfs2-cvs
mailing list