OrangeFS Build Details
|Building OrangeFS involves downloading the source software from orangefs.org onto a system preconfigured with several standard Linux packages. On this system you will extract and build OrangeFS into a portable directory named /opt/orangefs.|
In addition to a supported distribution of Linux, the OrangeFS Build system requires eight more Linux software packages. The names for these packages vary from one Linux distribution to another. For example, following are the package names you would require on a system running RHEL:
The method for installing these packages varies among Linux distributions. For example, to automatically install the required packages on a system running RHEL, you could enter the following command:
yum -y install gcc flex bison openssl-devel db4-devel kernel-devel perl make openldap-devel libattr-devel
If you do not plan to use certificate-based security, omit the option
openldap-devel from the command.
Because clients have different requirements for the OrangeFS build system, please read through all installation instructions for the client(s) you plan to use BEFORE you build OrangeFS.
To build OrangeFS, follow these steps:
1. Download Archive
Go to www.orangefs.org and download the compressed tar file into the /tmp/src directory (or similar directory for temporary storage). The tar file is named as follows:
version = version number of the OrangeFS distribution release
2. Extract Archive
Change Directory (cd) to /tmp/src, and extract the compressed tar file, then change to the newly created orangefs directory:
tar -xzf orangefs-<version>.tar.gz cd orangefs-<version>
Following is a sample listing of initial directories and files in the orangefs download directory:
/tmp/src/orangefs-v.2.9.8 $ ls aclocal.m4 config.save doc maint README AUTHORS configure docs Makefile.in README.name_change autom4te.cache configure.ac examples patches src cert-utils COPYING include prepare test ChangeLog CREDITS INSTALL pvfs2-config.h.in windows
3. Configure OrangeFS
Build a Makefile for OrangeFS that includes the installation location and the path of the system kernel, using the following command line format:
./configure --prefix=/opt/orangefs --with-kernel=<kernel_path> <protocol_options> <security_mode_option>
kernel_path = path to kernel source
In the second example,
`uname -r` will return the kernel version.
protocol_options = one of the following:
|If your network protocol is…||Include these options:|
|TCP||None, enabled by default|
|IB, using Mellanox IB libraries||
|IB, using OFED||
If you must run OrangeFS on more than one network protocol, certain configurations may result in slower response times on the faster interface(s).
security_mode_option = one of the following:
|To use this security mode…||Include this option:|
|Default||None, enabled by default|
with_db_backend = one of the following:
|To use this database…||Include this option:|
|Berkeley DB||None, enabled by default|
LMDB is a newer and preferred database backend option but is not yet the default. It will work only for new installs or existing LMDB installs; you cannot upgrade from existing Berkeley DB installations.
./configure --prefix=/opt/orangefs --with-kernel=/lib/modules/`uname -r`/build --enable-security-cert
When using the Upstream Kernel Module, omit
--with-kernel=/lib/modules/`uname -r`/build from the above command.
4. Build and Install
make to compile and install the software:
make make install
5. Build and Install Out-of-Tree Kernel Module
When using the Upstream Kernel Module, do not perform this step.
Compile and install the kernel module that your OrangeFS Linux clients will need later:
make kmod make kmod_prefix=/opt/orangefs kmod_install
OrangeFS by default works with SELinux in Permissive Mode.
To set SELinux to permissive mode, use the following command:
echo 0 > /selinux/enforce
To prevent SELinux from loading at boot time, edit
set the SELINUX value to “disabled”, for example:
The command can vary, depending on your Linux version.