Hi all,
Today's linux-next merge of the orangefs tree got a conflict in:
Documentation/filesystems/orangefs.rst
between commit:
18ccb2233fc5 ("docs: filesystems: convert orangefs.txt to ReST")
from Linus' tree and commit:
aa317d3351de ("orangefs: clarify build steps for test server in orangefs.txt")
from the orangefs tree.
I fixed it up (see below) and can carry the fix as necessary. This
is now fixed as far as linux-next is concerned, but any non trivial
conflicts should be mentioned to your upstream maintainer when your tree
is submitted for merging. You may also want to consider cooperating
with the maintainer of the conflicting tree to minimise any particularly
complex conflicts.
--
Cheers,
Stephen Rothwell
diff --cc Documentation/filesystems/orangefs.rst
index 7d6d4cad73c4,5a3865702a71..000000000000
--- a/Documentation/filesystems/orangefs.rst
+++ b/Documentation/filesystems/orangefs.rst
@@@ -41,17 -38,7 +41,7 @@@ Documentatio
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
@@@ -73,29 -60,37 +63,37 @@@ single line. Uncomment it and change t
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
@@@ -105,51 -100,55 +103,57 @@@ You can omit --prefix if you don't car
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::
-Localhost is fine for your 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
-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
Attachment:
pgpG43U6OYuu9.pgp
Description: OpenPGP digital signature
