Lustre Clients for Oracle Linux

Build a Lustre client on one system and then install the client package on each instance that mounts a Lustre file system.

1. To use a Lustre client with Oracle Linux, the kernel must be changed to Red Hat Compatible Kernel (RHCK). Switching kernel versions is described in Changing the default kernel in Oracle Linux.
2. Ensure that the system is running the RHCK kernel after reboot.

3. Install required packages using the following commands:

   release=$(cat /etc/os-release | grep ^VERSION= |cut -f2 -d\" |cut -f1 -d.)

   sudo dnf config-manager --set-enabled ol${release}_codeready_builder

   sudo dnf config-manager --enable ol${release}_developer_EPEL

   sudo yum-config-manager --enable ol${release}_developer

   sudo yum install git libtool patch pkgconfig libnl3-devel.x86_64 libblkid-devel libuuid-devel rpm-build kernel-rpm-macros kernel-devel kernel-abi-whitelists libmount libmount-devel libyaml-devel

4. Clone the Lustre client source repo and checkout the client using the following commands:

   git clone https://github.com/lustre/lustre-release.git lustre-client

   cd lustre-client/

   git checkout tags/2.15.5

5. Build the client and RPMs. All Lustre RPMs in the current directory are built using the following commands:

   sudo sh autogen.sh
   ./configure --enable-client
   sudo make
   sudo make rpms
   sudo make dkms-rpm

6. Inspect the RPMs:

   ls -l *.rpm

7. If you plan to install the Lustre client on the same instance you built it, run the following commands:

   sudo make install

   sudo depmod

   sudo modprobe lustre

Proceed to Installing on Oracle Linux 8.

These steps assume that you already built a Lustre client for Oracle Linux 8.

In this example, the Lustre Dynamic Kernel Module Support (DKMS) client package is used for its flexibility across different kernel versions. However, if you're using the DKMS client, Lustre modules must be built when it's installed or the kernel gets upgraded. You can choose the RPMs that you want to install, such as the non-DKMS kmod-lustre-client package for the Linux modules.

1. Create a directory on the instance where you want to install the Lustre client. For example:

   mkdir lustre-rpms

2. Copy the Lustre RPMs. In this example, we use the DKMS RPMs, such as:

   lustre-client-2.15.5-1.el8.x86_64.rpm
   lustre-client-dkms-2.15.5-1.el8.noarch.rpm

3. To use a Lustre client with Oracle Linux, the kernel must be changed to Red Hat Compatible Kernel (RHCK). Switching kernel versions is described in Changing the default kernel in Oracle Linux.
4. Ensure that the system is running the RHCK kernel after reboot.

5. Enable required Linux repository for dependencies, and install dependencies using the following commands:

   release=$(cat /etc/os-release | grep ^VERSION= |cut -f2 -d\" |cut -f1 -d.)

   sudo dnf config-manager --set-enabled ol${release}_codeready_builder

   sudo dnf config-manager --enable ol${release}_developer_EPEL

   sudo yum install dkms libmount-devel libyaml-devel

6. Install the client RPMs using the following command:

   sudo yum localinstall -y ./*.rpm

7. Test the modules using the following commands:

   sudo modprobe lustre

   sudo lsmod |grep lustre

8. The Lustre client is ready. Reboot the system.