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
===================================
OrangeFS is usually run in large installations with multiple servers and
controls clients which use libpvfs2. This does not control the
pvfs2-client-core.
-Create the filesystem.
+Create the filesystem::
-pvfs2-server -f /etc/orangefs/orangefs.conf
+ pvfs2-server -f /etc/orangefs/orangefs.conf
-Start the server.
+Start the server::
-systemctl start orangefs-server
+ systemctl start orangefs-server
-Test the server.
+Test the server::
-pvfs2-ping -m /pvfsmnt
+ pvfs2-ping -m /pvfsmnt
Start the client. The module must be compiled in or loaded before this
-point.
+point::
-systemctl start orangefs-client
+ systemctl start orangefs-client
-Mount the filesystem.
+Mount the filesystem::
-mount -t pvfs2 tcp://localhost:3334/orangefs /pvfsmnt
+ mount -t pvfs2 tcp://localhost:3334/orangefs /pvfsmnt
-USERSPACE FILESYSTEM SOURCE
++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
====================================
Where OrangeFS cannot be installed from distribution packages, it may be
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 --disable-usrint
+::
- ./configure --prefix=/opt/ofs --with-db-backend=lmdb
-make
++ ./configure --prefix=/opt/ofs --with-db-backend=lmdb --disable-usrint
-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.
++it comes to that question::
-/opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf
+ /opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf
-Create an /etc/pvfs2tab file.
+Create an /etc/pvfs2tab file::
-echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
- /etc/pvfs2tab
+ Localhost is fine for your pvfs2tab file:
+
+ echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
+ /etc/pvfs2tab
-Create the mount point you specified in the tab file if needed.
+Create the mount point you specified in the tab file if needed::
-mkdir /pvfsmnt
+ mkdir /pvfsmnt
-Bootstrap the server.
+Bootstrap the server::
-/opt/ofs/sbin/pvfs2-server -f /etc/pvfs2.conf
+ /opt/ofs/sbin/pvfs2-server -f /etc/pvfs2.conf
-Start the server.
+Start the server::
- /opt/osf/sbin/pvfs2-server /etc/pvfs2.conf
-/opt/ofs/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.
+test to verify that the server is running::
-/opt/ofs/bin/pvfs2-ls /pvfsmnt
+ /opt/ofs/bin/pvfs2-ls /pvfsmnt
If stuff seems to be working, load the kernel module and
-turn on the client core.
+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
++ /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
++ mount -t pvfs2 tcp://`hostname`:3334/orangefs /pvfsmnt
-RUNNING XFSTESTS
+Running xfstests
================
It is useful to use a scratch filesystem with xfstests. This can be