orangefs: clarify build steps for test server in orangefs.txt

Signed-off-by: Mike Marshall <hubcap@omnibond.com>

diff --git a/Documentation/filesystems/orangefs.txt b/Documentation/filesystems/orangefs.txt
index f4ba949..5a38657 100644 (file)
--- a/Documentation/filesystems/orangefs.txt
+++ b/Documentation/filesystems/orangefs.txt
@@ -38,16 +38,6 @@ DOCUMENTATION
 
 http://www.orangefs.org/documentation/
 
 
 http://www.orangefs.org/documentation/
 

-
-USERSPACE FILESYSTEM SOURCE
-===========================
-
-http://www.orangefs.org/download
-
-Orangefs versions prior to 2.9.3 would not be compatible with the
-upstream version of the kernel client.
-
-

 RUNNING ORANGEFS ON A SINGLE SERVER
 ===================================
 
 RUNNING ORANGEFS ON A SINGLE SERVER
 ===================================
 


@@ -91,6 +81,14 @@ Mount the filesystem.
 
 mount -t pvfs2 tcp://localhost:3334/orangefs /pvfsmnt
 
 
 mount -t pvfs2 tcp://localhost:3334/orangefs /pvfsmnt
 

+USERSPACE FILESYSTEM SOURCE
+===========================
+
+http://www.orangefs.org/download
+
+Orangefs versions prior to 2.9.3 would not be compatible with the
+upstream version of the kernel client.
+

 
 BUILDING ORANGEFS ON A SINGLE SERVER
 ====================================
 
 BUILDING ORANGEFS ON A SINGLE SERVER
 ====================================


@@ -102,18 +100,24 @@ You can omit --prefix if you don't care that things are sprinkled around
 in /usr/local.  As of version 2.9.6, OrangeFS uses Berkeley DB by
 default, we will probably be changing the default to LMDB soon.
 
 in /usr/local.  As of version 2.9.6, OrangeFS uses Berkeley DB by
 default, we will probably be changing the default to LMDB soon.
 

-./configure --prefix=/opt/ofs --with-db-backend=lmdb
+./configure --prefix=/opt/ofs --with-db-backend=lmdb --disable-usrint

 
 make
 
 make install
 
 
 make
 
 make install
 

-Create an orangefs config file.
+Create an orangefs config file by running pvfs2-genconfig and
+specifying a target config file. Pvfs2-genconfig will prompt you
+through. Generally it works fine to take the defaults, but you
+should use your server's hostname, rather than "localhost" when
+it comes to that question.

 
 /opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf
 
 Create an /etc/pvfs2tab file.
 
 
 /opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf
 
 Create an /etc/pvfs2tab file.
 

+Localhost is fine for your pvfs2tab file:
+

 echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
     /etc/pvfs2tab
 
 echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
     /etc/pvfs2tab
 


@@ -127,7 +131,7 @@ Bootstrap the server.
 
 Start the server.
 
 
 Start the server.
 

-/opt/osf/sbin/pvfs2-server /etc/pvfs2.conf
+/opt/ofs/sbin/pvfs2-server /etc/pvfs2.conf

 
 Now the server should be running. Pvfs2-ls is a simple
 test to verify that the server is running.
 
 Now the server should be running. Pvfs2-ls is a simple
 test to verify that the server is running.


@@ -137,11 +141,11 @@ test to verify that the server is running.
 If stuff seems to be working, load the kernel module and
 turn on the client core.
 
 If stuff seems to be working, load the kernel module and
 turn on the client core.
 

-/opt/ofs/sbin/pvfs2-client -p /opt/osf/sbin/pvfs2-client-core
+/opt/ofs/sbin/pvfs2-client -p /opt/ofs/sbin/pvfs2-client-core

 
 Mount your filesystem.
 
 
 Mount your filesystem.
 

-mount -t pvfs2 tcp://localhost:3334/orangefs /pvfsmnt
+mount -t pvfs2 tcp://`hostname`:3334/orangefs /pvfsmnt

 
 
 RUNNING XFSTESTS
 
 
 RUNNING XFSTESTS