I see all the other rst files, but no orangefs.rst...
I did see evidence on fs-devel a few months(?) ago that someone
was converting txt files to rst and that orangefs.txt
was one of them... perhaps there was something I should
have done but didn't? Anywho... what next?
[hubcap@hubcapsc linux]$ git log | grep ^commit | head -5
commit aa317d3351dee7cb0b27db808af0cd2340dcbaef | my commits I'll
commit 0e393a9a8f2a450862964451715d68e9a96a9c34 | try to get pulled
commit ec95f1dedc9c64ac5a8b0bdb7c276936c70fdedd | this time
commit 7111951b8d4973bda27ff663f2cf18b663d15b48 <--- Linux 5.6
commit 570203ec830dd451b8804cdef8036f7fca9f0311
[hubcap@hubcapsc linux]$ find . -name orangefs.rst
[hubcap@hubcapsc linux]$
-Mike "only three more days in the merge window"
On Wed, Apr 8, 2020 at 8:53 PM Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx> wrote:
>
> 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
