Changes between Version 2 and Version 3 of DBVersionRequired

Timestamp:

09/18/11 11:37:31 (20 months ago)

Author:

mtmoore

Comment:

--

DBVersionRequired

@@ -4 +4 @@
 OrangeFS support staff have identified an issue occurring with OrangeFS with versions of Berkeley DB prior to 4.8.30. The issue manifests itself in missing attribute information from files. The issues describe in these threads are examples of how the issue can manifest iteself:
 
-http://www.beowulf-underground.org/pipermail/pvfs2-users/2010-September/003186.html
-http://www.beowulf-underground.org/pipermail/pvfs2-users/2011-March/003298.html
+   * http://www.beowulf-underground.org/pipermail/pvfs2-users/2010-September/003186.html
+   * http://www.beowulf-underground.org/pipermail/pvfs2-users/2011-March/003298.html
 
 == Configuration Warning ==
-As of version 2.8.5 OrangeFS will warn about Berkeley DB versions prior to 4.8.30. Of course the warning can be ignored but may lead to the issues described. It is highly recommend for production OrangeFS file systems to use a new version of Berkeley DB. 
+As of version 2.8.5 OrangeFS will warn about Berkeley DB versions prior to 4.8.30. Of course the warning can be ignored but may lead to the issues described. It is highly recommend for production OrangeFS file systems to use version 4.8.30 of Berkeley DB. 
 
 == Distribution provided Berkeley DB ==
-Many OS distributions do not come with that new of a version of Berkeley DB. Although requirements are different for all sites, the easiest work-around is to install a copy of Berkeley DB 4.8.30 in a non-standard location.
+Many OS distributions do not come with version 4.8.30 of Berkeley DB. 
 
 Determining the installed version of Berkeley DB varies based on package manager however your distributions equivalent of
 `yum info db4` should provide the version. If db4 utilties are installed (e.g. there is a `db_stat` executable in your path) the version can also be determined with `db_stat -V`
+
+Although requirements are different for all sites, the easiest work-around is to install a copy of Berkeley DB 4.8.30 in a non-standard location.
 
 
@@ -33 +35 @@
 
 == Non-standard location installation ==
+
+Following the Berkeley DB installation instructions is best. However, below is a quick walk-through of the general steps. The version of Berkeley DB built here is not meant as a replacement for the version provided with your distribution. It is intended as a stand-alone version of Berkeley DB that provides the needed functionality for use with OrangeFS.
+
+   * `tar -xzf db-4.8.30.tar.gz`
+   * `cd db-4.8.30`
+   * `cd build_unix`
+   * `../dist/configure --prefix=/usr/local/db4.8.30`
+   * `make`
+   * `sudo make install`
+
+Again, verify these steps are what you want to do before executing them. They are an example only.
+
+== Using non-standard Berkeley DB location with OrangeFS ==
+
+To use a non-standard Berkeley DB location (one that is not in the default search paths) simply specify `--with-db=<path>` when configuring OrangeFS. Assuming the above installation the configure step would look like:
+
+`./configure --prefix=/usr/local/orangefs --with-db=/usr/local/db4.8.30`