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

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

1 files changed, 19 insertions, 15 deletions

diff --git a/Documentation/filesystems/orangefs.txt b/Documentation/filesystems/orangefs.txt
index f4ba94950e3f..5a3865702a71 100644
--- a/Documentation/filesystems/orangefs.txt
+++ b/Documentation/filesystems/orangefs.txt
@@ -38,16 +38,6 @@ 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
 ===================================
 
@@ -91,6 +81,14 @@ Mount the filesystem.
 
 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
 ====================================
@@ -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.
 
-./configure --prefix=/opt/ofs --with-db-backend=lmdb
+./configure --prefix=/opt/ofs --with-db-backend=lmdb --disable-usrint
 
 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.
 
+Localhost is fine for your pvfs2tab file:
+
 echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
     /etc/pvfs2tab
 
@@ -127,7 +131,7 @@ Bootstrap 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.
@@ -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.
 
-/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 -t pvfs2 tcp://localhost:3334/orangefs /pvfsmnt
+mount -t pvfs2 tcp://`hostname`:3334/orangefs /pvfsmnt
 
 
 RUNNING XFSTESTS